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"
}
}