POST
/player/validate
ตรวจสอบผู้เล่น
ตรวจสอบ ID ผู้เล่นของเกมที่ระบุ โดยส่งฟิลด์ไดนามิกที่ได้จาก endpoint “ดูฟิลด์ที่ต้องกรอกตามหมวดหมู่” มาด้วย
ขีดจำกัดการเรียกใช้โควตาตรวจสอบผู้เล่นรายวัน (ต่อบัญชี) โดยไม่มี header X-RateLimit
หมายเหตุ: เช็กได้จาก endpoint “ดูฟิลด์ที่ต้องกรอกตามหมวดหมู่” ว่าแต่ละเกมต้องใช้ฟิลด์ใดบ้าง แล้วส่งฟิลด์ที่จำเป็นทั้งหมดใน request body ค่า PLAYER_NOT_FOUND หมายถึงเกมยืนยันแล้วว่าไม่มี ID นี้ ส่วน PLAYER_CHECK_UNAVAILABLE (HTTP 503 ลองใหม่ได้) หมายถึงตอนนี้ยังตรวจสอบ ID ไม่ได้ และ ID นั้นไม่ได้ถูกปฏิเสธ
Body ของคำขอ
| ชื่อ | ชนิด | จำเป็น | คำอธิบาย | ตัวอย่าง |
|---|---|---|---|---|
| sub_category_id | number | ใช่ | ID หมวดหมู่ย่อยของสินค้า ค้นหาค่านี้ได้จากหน้าสำรวจแคตตาล็อก (Catalog Explorer) | 999 |
| player_id | string | ใช่ | ID ผู้เล่นในเกม | 123456789 |
| ...requirements | varies | ไม่ | ฟิลด์เพิ่มเติมจาก endpoint “ดูฟิลด์ที่ต้องกรอกตามหมวดหมู่” ใส่ 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"
}
}