← العودة للوحة التحكم

API Documentation

وثائق ربط الـ API

مفتاح الـ API

يجب إرسال مفتاح الـ API مع كل طلب في الـ Header باسم X-API-Key

86ea414811cb28505b6180c554fbba6e
تحذير: حافظ على سرية مفتاح الـ API ولا تشاركه علنياً. يمكنك تجديده من لوحة التحكم في أي وقت.

المنتجات المتاحة (Free Fire Diamonds)

استخدم قيمة product_name عند إنشاء الطلب:

100 Diamond
$1.00 USD
product_name: "100"
210 Diamond
$2.00 USD
product_name: "210"
530 Diamond
$5.00 USD
product_name: "530"
1,080 Diamond
$10.00 USD
product_name: "1080"
2,200 Diamond
$20.00 USD
product_name: "2200"

POST /api/order - إنشاء طلب جديد

إرسال طلب شراء دايموند لحساب لاعب. البوت يعالج الطلب تلقائياً.

Headers المطلوبة

Headerالقيمةالحالة
Content-Typeapplication/jsonمطلوب
X-API-Keyمفتاح الـ API الخاص بكمطلوب

Body Parameters

الحقلالنوعالوصفالحالة
player_id string معرف اللاعب في Free Fire مطلوب
product_name string اسم المنتج (100, 210, 530, 1080, 2200) مطلوب
quantity integer الكمية (الافتراضي: 1) اختياري
external_ref string رقم مرجعي خارجي لتتبع الطلب في نظامك اختياري

أمثلة الكود

cURL
PHP
Python
JavaScript
curl -X POST "https://goldrazer.elyonko.uk/api/order" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: 86ea414811cb28505b6180c554fbba6e" \
  -d '{
    "player_id": "123456789",
    "product_name": "530",
    "quantity": 1,
    "external_ref": "ORDER-001"
  }'
<?php
$apiKey = "86ea414811cb28505b6180c554fbba6e";
$baseUrl = "https://goldrazer.elyonko.uk";

$data = [
    "player_id" => "123456789",
    "product_name" => "530",
    "quantity" => 1,
    "external_ref" => "ORDER-001"
];

$ch = curl_init("$baseUrl/api/order");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($data),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "X-API-Key: $apiKey"
    ]
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($httpCode === 201) {
    echo "Order created! ID: " . $result["order_id"];
} else {
    echo "Error: " . $result["error"];
}
?>
import requests

API_KEY = "86ea414811cb28505b6180c554fbba6e"
BASE_URL = "https://goldrazer.elyonko.uk"

response = requests.post(
    f"{BASE_URL}/api/order",
    json={
        "player_id": "123456789",
        "product_name": "530",
        "quantity": 1,
        "external_ref": "ORDER-001"
    },
    headers={
        "X-API-Key": API_KEY
    }
)

if response.status_code == 201:
    data = response.json()
    print(f"Order created! ID: {data['order_id']}")
else:
    print(f"Error: {response.json()['error']}")
const API_KEY = "86ea414811cb28505b6180c554fbba6e";
const BASE_URL = "https://goldrazer.elyonko.uk";

const response = await fetch(`${BASE_URL}/api/order`, {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "X-API-Key": API_KEY
    },
    body: JSON.stringify({
        player_id: "123456789",
        product_name: "530",
        quantity: 1,
        external_ref: "ORDER-001"
    })
});

const data = await response.json();

if (response.status === 201) {
    console.log(`Order created! ID: ${data.order_id}`);
} else {
    console.log(`Error: ${data.error}`);
}

الاستجابة الناجحة (201)

{
    "success": true,
    "order_id": 15,
    "message": "Order queued successfully"
}

GET /api/order/{order_id} - استعلام عن حالة طلب

التحقق من حالة طلب معين ومعرفة نتيجته (رقم المعاملة أو كود PIN).

أمثلة الكود

cURL
PHP
Python
JavaScript
curl -X GET "https://goldrazer.elyonko.uk/api/order/15" \
  -H "X-API-Key: 86ea414811cb28505b6180c554fbba6e"
<?php
$apiKey = "86ea414811cb28505b6180c554fbba6e";
$baseUrl = "https://goldrazer.elyonko.uk";
$orderId = 15;

$ch = curl_init("$baseUrl/api/order/$orderId");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-API-Key: $apiKey"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$order = json_decode($response, true);
echo "Status: " . $order["status"];
echo "Transaction ID: " . $order["transaction_id"];
?>
import requests

API_KEY = "86ea414811cb28505b6180c554fbba6e"
BASE_URL = "https://goldrazer.elyonko.uk"
order_id = 15

response = requests.get(
    f"{BASE_URL}/api/order/{order_id}",
    headers={"X-API-Key": API_KEY}
)

order = response.json()
print(f"Status: {order['status']}")
print(f"Transaction ID: {order['transaction_id']}")
const API_KEY = "86ea414811cb28505b6180c554fbba6e";
const BASE_URL = "https://goldrazer.elyonko.uk";
const orderId = 15;

const response = await fetch(`${BASE_URL}/api/order/${orderId}`, {
    headers: { "X-API-Key": API_KEY }
});

const order = await response.json();
console.log(`Status: ${order.status}`);
console.log(`Transaction ID: ${order.transaction_id}`);

الاستجابة الناجحة (200)

{
    "id": 15,
    "player_id": "123456789",
    "product_name": "530",
    "amount": 5.0,
    "status": "completed",
    "pin_code": null,
    "transaction_id": "RG-2024-XXXXX",
    "error_message": null,
    "created_at": "2026-02-13T10:30:00",
    "completed_at": "2026-02-13T10:31:45"
}

حالات الطلب

الحالةالوصف
pendingالطلب في الانتظار
processingجاري تنفيذ الطلب بواسطة البوت
completedتم تنفيذ الطلب بنجاح
failedفشل تنفيذ الطلب (راجع error_message)

GET /api/orders - قائمة الطلبات

استرجاع آخر 100 طلب مع إمكانية الفلترة حسب الحالة.

Query Parameters

الحقلالنوعالوصفالحالة
status string فلترة حسب الحالة (pending, processing, completed, failed) اختياري

أمثلة الكود

cURL
PHP
Python
JavaScript
curl -X GET "https://goldrazer.elyonko.uk/api/orders?status=completed" \
  -H "X-API-Key: 86ea414811cb28505b6180c554fbba6e"
<?php
$apiKey = "86ea414811cb28505b6180c554fbba6e";
$baseUrl = "https://goldrazer.elyonko.uk";

$ch = curl_init("$baseUrl/api/orders?status=completed");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "X-API-Key: $apiKey"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
foreach ($data["orders"] as $order) {
    echo "Order #{$order['id']} - {$order['status']}\n";
}
?>
import requests

API_KEY = "86ea414811cb28505b6180c554fbba6e"
BASE_URL = "https://goldrazer.elyonko.uk"

response = requests.get(
    f"{BASE_URL}/api/orders",
    params={"status": "completed"},
    headers={"X-API-Key": API_KEY}
)

data = response.json()
for order in data["orders"]:
    print(f"Order #{order['id']} - {order['status']}")
const API_KEY = "86ea414811cb28505b6180c554fbba6e";
const BASE_URL = "https://goldrazer.elyonko.uk";

const response = await fetch(`${BASE_URL}/api/orders?status=completed`, {
    headers: { "X-API-Key": API_KEY }
});

const data = await response.json();
data.orders.forEach(order => {
    console.log(`Order #${order.id} - ${order.status}`);
});

الاستجابة الناجحة (200)

{
    "orders": [
        {
            "id": 15,
            "player_id": "123456789",
            "product_name": "530",
            "amount": 5.0,
            "status": "completed",
            "pin_code": null,
            "transaction_id": "RG-2024-XXXXX",
            "created_at": "2026-02-13T10:30:00",
            "completed_at": "2026-02-13T10:31:45"
        }
    ]
}

رموز الأخطاء

الكودالوصفالسبب
400 Bad Request بيانات ناقصة أو غير صحيحة (player_id أو product_name مفقود)
401 Unauthorized مفتاح الـ API غير صحيح أو مفقود
404 Not Found الطلب غير موجود
429 Too Many Requests تجاوزت الحد الأقصى للطلبات (60 طلب/دقيقة)

مثال استجابة خطأ

{
    "error": "Invalid API key"
}

حدود الاستخدام (Rate Limiting)

الحد الأقصى: 60 طلب في الدقيقة لكل مفتاح API.
عند تجاوز الحد، ستحصل على استجابة 429 مع حقل retry_after يوضح عدد الثواني المتبقية.
{
    "error": "Rate limit exceeded. Maximum 60 requests per minute.",
    "retry_after": 35
}

دليل الربط السريع

الخطوات الأساسية لربط موقعك:

1. انسخ مفتاح الـ API من الأعلى
2. أرسل طلب POST إلى /api/order مع بيانات اللاعب والمنتج
3. احفظ order_id من الاستجابة
4. استعلم عن حالة الطلب دورياً عبر /api/order/{order_id}
5. عندما تصبح الحالة completed، الطلب تم بنجاح وستجد transaction_id

مثال كامل (PHP) - من إنشاء الطلب إلى متابعته

<?php
$apiKey = "86ea414811cb28505b6180c554fbba6e";
$baseUrl = "https://goldrazer.elyonko.uk";

function createOrder($baseUrl, $apiKey, $playerId, $product, $ref = null) {
    $data = [
        "player_id" => $playerId,
        "product_name" => $product,
        "quantity" => 1,
        "external_ref" => $ref
    ];

    $ch = curl_init("$baseUrl/api/order");
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($data),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            "Content-Type: application/json",
            "X-API-Key: $apiKey"
        ]
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    return ["code" => $httpCode, "data" => json_decode($response, true)];
}

function checkOrder($baseUrl, $apiKey, $orderId) {
    $ch = curl_init("$baseUrl/api/order/$orderId");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ["X-API-Key: $apiKey"]
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

$result = createOrder($baseUrl, $apiKey, "123456789", "530", "MY-ORDER-001");

if ($result["code"] === 201) {
    $orderId = $result["data"]["order_id"];
    echo "Order created: #$orderId\n";

    while (true) {
        sleep(10);
        $order = checkOrder($baseUrl, $apiKey, $orderId);

        if ($order["status"] === "completed") {
            echo "Done! Transaction: " . $order["transaction_id"] . "\n";
            break;
        } elseif ($order["status"] === "failed") {
            echo "Failed: " . $order["error_message"] . "\n";
            break;
        }

        echo "Status: " . $order["status"] . " - waiting...\n";
    }
}
?>
Razer Gold Bot API v1.0