وثائق ربط الـ API
يجب إرسال مفتاح الـ API مع كل طلب في الـ Header باسم X-API-Key
استخدم قيمة product_name عند إنشاء الطلب:
إرسال طلب شراء دايموند لحساب لاعب. البوت يعالج الطلب تلقائياً.
| Header | القيمة | الحالة |
|---|---|---|
Content-Type | application/json | مطلوب |
X-API-Key | مفتاح الـ API الخاص بك | مطلوب |
| الحقل | النوع | الوصف | الحالة |
|---|---|---|---|
player_id |
string | معرف اللاعب في Free Fire | مطلوب |
product_name |
string | اسم المنتج (100, 210, 530, 1080, 2200) | مطلوب |
quantity |
integer | الكمية (الافتراضي: 1) | اختياري |
external_ref |
string | رقم مرجعي خارجي لتتبع الطلب في نظامك | اختياري |
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}`);
}
{
"success": true,
"order_id": 15,
"message": "Order queued successfully"
}
التحقق من حالة طلب معين ومعرفة نتيجته (رقم المعاملة أو كود PIN).
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}`);
{
"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) |
استرجاع آخر 100 طلب مع إمكانية الفلترة حسب الحالة.
| الحقل | النوع | الوصف | الحالة |
|---|---|---|---|
status |
string | فلترة حسب الحالة (pending, processing, completed, failed) | اختياري |
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}`);
});
{
"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"
}
429 مع حقل retry_after يوضح عدد الثواني المتبقية.
{
"error": "Rate limit exceeded. Maximum 60 requests per minute.",
"retry_after": 35
}
/api/order مع بيانات اللاعب والمنتجorder_id من الاستجابة/api/order/{order_id}completed، الطلب تم بنجاح وستجد transaction_id
<?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";
}
}
?>