หมุนกงล้อ
ใช้งานได้POST
/api/v1/wheel/spinใช้สิทธิ์หมุน 1 ครั้ง — ระบบสุ่มช่องที่ออกและเครดิตรางวัลเข้ากระเป๋าทันที ตอบช่องที่ออกให้ client
ผลถูกสุ่มฝั่งระบบและตัดสินก่อนตอบกลับ — แอนิเมชันฝั่ง client เป็นการแสดงผลเท่านั้น
รางวัลที่มากกว่า 0 เข้ากระเป๋าทันที (รายการชนิด WHEEL ในประวัติธุรกรรม) และเพิ่มเทิร์นฝากเท่ากับรางวัล × wager_multiplier
กงล้อใช้ได้เฉพาะไซต์ที่เปิดใช้ที่ระดับ agent (กระเป๋าโหมด TRANSFER) — ไม่เข้าเงื่อนไขจะได้ 6203
Headers
| ฟิลด์ | ชนิด | จำเป็น | คำอธิบาย |
|---|---|---|---|
| Authorization | string | ใช่ | ใช้ — แนบ Bearer <access_token> ของสมาชิก |
| X-Api-Key | string | ใช่ | API key ของ agent (ak_…) จากหน้า bo |
| X-Timestamp | string | ใช่ | เวลา sign เป็น unix milliseconds (คลาดเคลื่อนได้ ±300 วินาที) |
| X-Nonce | string | ใช่ | ค่าไม่ซ้ำต่อ request (UUIDv4) กัน replay |
| X-Signature | string | ใช่ | hex(HMAC-SHA256(secret, canonical)) — ดูหน้า Authentication |
| X-Player-IP | string | — | IP จริงของผู้เล่น (IPv4/IPv6) — แนะนำให้ส่ง (ใช้ใน login history) |
| X-Player-UA | string | — | User-Agent ของผู้เล่น (optional — ลง login history) |
| X-Request-Id | string | — | correlation id ของฝั่งคุณ — ระบบ echo กลับใน request_uuid (แนะนำให้ส่ง) |
| x-lang | string | — | th (default) หรือ en — ภาษาของ message |
Response
ฟิลด์ใน data
| ฟิลด์ | ชนิด | จำเป็น | คำอธิบาย |
|---|---|---|---|
| slot_index | number | — | ช่องที่ออก — ให้แอนิเมชันหมุนไปหยุดที่ช่องนี้ |
| label | string | — | ข้อความของช่องที่ออก |
| prize_amount_thb | string | — | มูลค่ารางวัล (THB, string) — "0" = ไม่ได้รางวัล |
| balance | string | null | — | ยอดคงเหลือหลังรางวัลเข้ากระเป๋า — null เมื่อช่องที่ออกไม่มีรางวัล (ไม่มีการเครดิต) |
ตัวอย่าง response
{
"success": true,
"code": 0,
"message": "Spin completed",
"data": {
"slot_index": 3,
"label": "20 บาท",
"prize_amount_thb": "20",
"balance": "195.50"
},
"request_uuid": "c4a8f2d6-1b39-4e75-90cd-5e7a3f8b1d64"
}Error codes ที่พบได้
| code | ชื่อ | HTTP | ข้อความ |
|---|---|---|---|
| 6202 | WHEEL_NO_SPINS | 400 | ไม่มีสิทธิ์หมุนคงเหลือสิทธิ์หมุนหมด (spins_available = 0) — ฝากเพิ่มให้ครบตามเงื่อนไขเพื่อรับสิทธิ์ใหม่ |
| 6201 | WHEEL_NOT_ENABLED | 400 | กงล้อนำโชคยังไม่เปิดใช้งานagent ปิดกงล้ออยู่ |
| 6203 | WHEEL_NOT_ELIGIBLE | 400 | บัญชีนี้ไม่สามารถใช้กงล้อนำโชคได้บัญชีนี้ใช้กงล้อไม่ได้ (ไซต์/กระเป๋าไม่เข้าเงื่อนไข) |
| 9002 | SERVICE_UNAVAILABLE | 503 | บริการไม่พร้อมใช้งานระบบออกรางวัลไม่พร้อมใช้งานชั่วคราว — สิทธิ์ไม่ถูกหัก ลองใหม่ภายหลัง |
| 1001 | UNAUTHORIZED | 401 | ไม่ได้รับอนุญาต |
| 1007 | TOKEN_INVALID | 401 | โทเค็นไม่ถูกต้อง |