POST
/player/validate
ကစားသူ စစ်ဆေးခြင်း
ဂိမ်းတစ်ခုအတွက် Player ID ကို စစ်ဆေးပါ။ “အမျိုးအစား လိုအပ်ချက်များ ရယူခြင်း” endpoint မှ ပြန်ပေးသော လိုအပ်ချက် field များကို ထည့်ပေးပါ။
တောင်းဆိုနှုန်း ကန့်သတ်ချက်အကောင့်အလိုက် နေ့စဉ် ကစားသူ စစ်ဆေးခွင့် အရေအတွက်၊ X-RateLimit header မပါ
မှတ်ချက်: ဂိမ်းတစ်ခုစီအတွက် လိုအပ်သော field များကို “အမျိုးအစား လိုအပ်ချက်များ ရယူခြင်း” endpoint ဖြင့် စစ်ကြည့်ပါ။ လိုအပ်သော field အားလုံးကို request body တွင် ထည့်ပါ။ PLAYER_NOT_FOUND ဆိုသည်မှာ ထို ID မရှိကြောင်း ဂိမ်းဘက်က အတည်ပြုထားခြင်း ဖြစ်ပါသည်။ PLAYER_CHECK_UNAVAILABLE (HTTP 503၊ ပြန်စမ်းနိုင်) ဆိုသည်မှာ ယခုအချိန်တွင် ID ကို စစ်ဆေး၍ မရခြင်းသာ ဖြစ်ပြီး ID ကို ငြင်းပယ်ထားခြင်း မဟုတ်ပါ။
တောင်းဆိုမှုတွင် ပို့ရမည့် ဒေတာ
| အမည် | အမျိုးအစား | လိုအပ် | ဖော်ပြချက် | ဥပမာ |
|---|---|---|---|---|
| sub_category_id | number | ဟုတ် | ကုန်ပစ္စည်း၏ အမျိုးအစားခွဲ ID ဖြစ်ပါသည်။ ကုန်ပစ္စည်းစာရင်း ရှာဖွေရေး (Catalog Explorer) ကို အသုံးပြု၍ ဤနံပါတ်ကို ရှာဖွေနိုင်ပါသည်။ | 999 |
| player_id | string | ဟုတ် | ဂိမ်းထဲရှိ Player ID။ | 123456789 |
| ...requirements | varies | မဟုတ် | “အမျိုးအစား လိုအပ်ချက်များ ရယူခြင်း” endpoint မှ ရသော နောက်ထပ် field များ။ field_name တစ်ခုစီကို key အဖြစ်ထား၍ အသုံးပြုသူ ထည့်ပေးသော တန်ဖိုးကို ထည့်ပါ။ | "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"
}
}