نقطة التحقق من اللاعب

يحلّ التحقق من اللاعب حسابًا داخل اللعبة قبل تحرّك أي مال. فهو يؤكّد وجود المعرّف لذلك المنتج، ويعيد الاسم داخل اللعبة ليتأكّد مشتريك منه، ويكشف المنطقة فيُرفض الطلب عابر المناطق مبكرًا بدل أن يفشل بعد الدفع.

أيّ الحقول ترسل

جسم الطلب زوج ثابت إضافةً إلى ما تشترطه اللعبة نفسها. اقرأ GET /catalog/category/:categoryId/requirements أولًا، ثم أرسل كل field_name تعيده إلى جانب sub_category_id و player_id. الحقول من نوع single_select أو multi_select لا تقبل إلا قيمة من قائمة select_options الخاصة بها؛ وأي شيء آخر يفشل في التحقق بالكود INVALID_PRODUCT_CONFIG بدل أن يصل إلى اللعبة.

تعيد الاستجابة الناجحة الاسم داخل اللعبة والمنطقة خلف المعرّف. قارن تلك المنطقة بالمنتج الذي توشك أن تبيعه: عدم التطابق يُرفض بالكود REGION_MISMATCH، والتقاطه وقت التحقق يكلّف طلبًا واحدًا، بينما التقاطه وقت الطلب يكلّف دورة استرداد كاملة.

POST

/player/validate

Validate Player

Validate a player ID for a specific game. Include the dynamic requirement fields returned by the Get Category Requirements endpoint.

حدّ المعدلHas its own rate limiter

ملاحظة: Use the Get Category Requirements endpoint to discover which fields are needed for each game. Include all required fields in the request body.

جسم الطلب

الاسمالنوعمطلوبالوصفمثال
sub_category_idnumberنعمThe subcategory ID of the product. Use Catalog Explorer to find this.999
player_idstringنعمThe in-game player ID.123456789
...requirementsvariesلاAdditional fields from the Get Category Requirements endpoint. Include each field_name as a key with the user-provided value."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"
  }
}

أرسل طلبًا حقيقيًا من هذه الصفحة

الصق مفتاح API لمناداة هذه النقاط مباشرةً. يبقى المفتاح في تبويب المتصفّح هذا ولا يُرسل إلا إلى الواجهة البرمجية نفسها.

Enter your API key to use the interactive playground. Get your API key

اختر نقطة نهاية

Use Catalog Explorer to find this

No requirements for this category.

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

جديد على المنصة؟ ابدأ من نظرة عامة على واجهة شحن الألعاب للموزّعين، أو اقرأ نظرة عامة على برنامج موزّعي SHOP2TOPUP لمعرفة كيفية عمل حساب الشريك.

مرجع API التحقق من اللاعب — POST /player/validate