เปิดเกม
ใช้งานได้POST
/api/v1/games/:gameId/launchขอลิงก์เข้าเกมให้สมาชิก (ต้องใช้ access token) — ระบบตรวจว่าเกม/ค่ายเปิดให้ไซต์ของคุณ แล้วออก launch_url จากค่ายเกมให้เปิดในเบราว์เซอร์ของผู้เล่น
เปิด launch_url ในเบราว์เซอร์ของผู้เล่นทันทีที่ได้รับ (redirect เต็มหน้า หรือ iframe) — ลิงก์มีอายุสั้น หมดอายุตาม expires_at อย่าเก็บไว้ใช้ซ้ำ
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) — บังคับบน endpoint นี้เมื่อใช้ช่องทาง external (ส่งต่อให้ค่ายเกม) |
| 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 |
Path parameters
| ฟิลด์ | ชนิด | จำเป็น | คำอธิบาย |
|---|---|---|---|
| gameId | string (uuid) | ใช่ | id เกมจากรายการเกม |
Request bodyapplication/json
| ฟิลด์ | ชนิด | จำเป็น | คำอธิบาย |
|---|---|---|---|
| device_type | string | ใช่ | ชนิดอุปกรณ์ของผู้เล่นdesktop | mobile |
| return_url | string (URL) | ใช่ | URL หน้าเว็บของคุณที่ค่ายเกมพาผู้เล่นกลับเมื่อออกจากเกม |
| lang | string | — | ภาษาในเกม (ISO 639-1, ไม่เกิน 8 ตัวอักษร) — ไม่ส่ง = th |
ตัวอย่าง request
{
"device_type": "mobile",
"return_url": "https://www.your-site.com/lobby",
"lang": "th"
}Response
ฟิลด์ใน data
| ฟิลด์ | ชนิด | จำเป็น | คำอธิบาย |
|---|---|---|---|
| launch_url | string (URL) | — | ลิงก์เข้าเกมจากค่าย — เปิดในเบราว์เซอร์ของผู้เล่น (redirect หรือ iframe) |
| expires_at | string (ISO 8601) | — | เวลาหมดอายุของ launch_url |
ตัวอย่าง response
{
"success": true,
"code": 0,
"message": "สำเร็จ",
"data": {
"launch_url": "https://m.pg-games.example.com/126/index.html?ot=eyJhbGciOiJIUzI1NiIs…",
"expires_at": "2026-07-05T12:15:00.000Z"
},
"request_uuid": "9f2b7d1e-4a83-4c1f-b2ce-6d5a0e8f3c21"
}Error codes ที่พบได้
| code | ชื่อ | HTTP | ข้อความ |
|---|---|---|---|
| 3001 | GAME_NOT_FOUND | 404 | ไม่พบเกมไม่พบเกม หรือเกมนี้ถูกปิดสำหรับไซต์ของคุณ |
| 3002 | PROVIDER_UNAVAILABLE | 503 | ค่ายเกมไม่พร้อมให้บริการค่ายเกมปิดปรับปรุง/ไม่ได้เปิดให้ไซต์ของคุณ หรือฝั่งค่ายปฏิเสธการเปิดเกม |
| 4001 | VALIDATION_ERROR | 400 | ข้อมูลไม่ถูกต้อง |
| 9002 | SERVICE_UNAVAILABLE | 503 | บริการไม่พร้อมใช้งานระบบเกมภายในไม่ตอบสนองชั่วคราว — ลองใหม่ภายหลัง |