POST
/player/validate
التحقق من اللاعب
تحقق من معرّف لاعب في لعبة محددة. أرسل معه حقول المتطلبات الديناميكية التي تعيدها نقطة الوصول «جلب متطلبات الفئة».
حدّ المعدلحصتك اليومية من عمليات التحقق من اللاعبين (لكل حساب)، دون ترويسات X-RateLimit
ملاحظة: استخدم نقطة الوصول «جلب متطلبات الفئة» لمعرفة الحقول المطلوبة لكل لعبة، ثم أرسلها كلها في جسم الطلب. يعني PLAYER_NOT_FOUND أن اللعبة أكدت عدم وجود المعرّف، أما PLAYER_CHECK_UNAVAILABLE (HTTP 503، قابل لإعادة المحاولة) فيعني أن التحقق من المعرّف تعذّر حالياً وأنه لم يُرفض.
جسم الطلب
| الاسم | النوع | مطلوب | الوصف | مثال |
|---|---|---|---|---|
| sub_category_id | number | نعم | معرّف الفئة الفرعية للمنتج. تجده في مستكشف الكتالوج. | 999 |
| player_id | string | نعم | معرّف اللاعب داخل اللعبة. | 123456789 |
| ...requirements | varies | لا | حقول إضافية من نقطة الوصول «جلب متطلبات الفئة». أرسل كل field_name مفتاحاً مع القيمة التي أدخلها المستخدم. | "server": "Asia" |
الطلب
curl -s -X POST "https://shop2topup.com/api/endpoints/v1/player/validate" \
-H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
-H "Content-Type: application/json" \
-d '{
"sub_category_id": 999,
"player_id": 123456789
}'مثال استجابة
{
"success": true,
"player": {
"player_id": "123456789",
"player_name": "ProGamer99",
"region": "Asia"
}
}