اندپوینت اعتبارسنجی بازیکن

اعتبارسنجی بازیکن پیش از جابه‌جایی هر پولی حساب درون‌بازی را مشخص می‌کند. تأیید می‌کند که شناسه برای آن محصول وجود دارد، نام درون‌بازی را برمی‌گرداند تا خریدارتان آن را بررسی کند و منطقه را نشان می‌دهد؛ بنابراین سفارش بین‌منطقه‌ای از ابتدا رد می‌شود و پس از پرداخت شکست نمی‌خورد.

چه فیلدهایی باید فرستاده شوند

بدنه درخواست یک جفت ثابت است به‌علاوه هر چیزی که خود بازی لازم دارد. ابتدا 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 را بچسبانید. کلید در همین تب مرورگر می‌ماند و تنها به خود 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.

تازه با پلتفرم آشنا شده‌اید؟ از معرفی API شارژ بازی برای نمایندگان فروش شروع کنید، یا معرفی برنامه نمایندگی SHOP2TOPUP را بخوانید تا ببینید حساب شریک چگونه کار می‌کند.

مرجع API اعتبارسنجی بازیکن — POST /player/validate