รายการเกม

ใช้งานได้

GET/api/v1/games

เกมทั้งหมดที่เล่นได้บนไซต์ของคุณ แบ่งหน้า (ค่าเริ่มต้นหน้าละ 30) — กรองตามค่าย/ประเภท/แท็ก และค้นหาจากชื่อเกมได้ เรียงตาม sort_order แล้วตามชื่อ

โครง data เป็น { data: [...], pagination: { page, limit, total, total_pages } } — บล็อกแบ่งหน้าชื่อ pagination ไม่ใช่ meta

Headers

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
Authorization	string	—	ไม่ใช้ — endpoint นี้เป็น public ไม่ต้องแนบ 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

Query parameters

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
provider_id	string (uuid)	—	กรองเฉพาะเกมของค่ายนี้ (id จากรายชื่อค่ายเกม)
category	string	—	กรองตามประเภทเกมSLOT \| ARCADE \| LIVE_CASINO \| TABLE \| FISHING \| SPORT \| LOTTERY \| ESPORT \| KENO \| COCKFIGHT
tag	string	—	กรองตามแท็กเกมPOPULAR \| NEW \| HOT
search	string	—	ค้นหาจากชื่อเกม (contains, ไม่แยกตัวพิมพ์เล็ก-ใหญ่)
page	number	—	หน้าที่ต้องการ เริ่มที่ 1 (ค่าเริ่มต้น 1)
limit	number	—	จำนวนเกมส์ต่อหน้า (ค่าเริ่มต้น 50, สูงสุด 100)

Response

ฟิลด์ใน data

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
data[]	array<object>	—	รายการเกมของหน้านี้
└ id	string (uuid)	—	id เกม — ใช้เปิดเกมผ่าน POST /api/v1/games/:gameId/launch
└ provider_id	string (uuid)	—	id ค่ายเจ้าของเกม
└ provider	object	—	ข้อมูลย่อของค่ายเกม
└ code	string	—	รหัสค่าย เช่น PGSOFT
└ name	string	—	ชื่อค่าย
└ logo_url	string \| null	—	URL โลโก้ค่าย
└ code	string	—	รหัสเกมฝั่งค่าย
└ name	string	—	ชื่อเกมสำหรับแสดงผล
└ type	string	—	ประเภทเกมSLOT \| ARCADE \| LIVE_CASINO \| TABLE \| FISHING \| SPORT \| LOTTERY \| ESPORT \| KENO \| COCKFIGHT
└ thumbnail_url	string \| null	—	URL ภาพปกเกม
└ tags	string[]	—	แท็กของเกม (ใช้ทำป้าย เช่น ฮิต/ใหม่)POPULAR \| NEW \| HOT
└ rtp	string \| null	—	ค่า RTP เป็นสตริงทศนิยม เช่น "96.95" (null = ไม่ระบุ)
└ volatility	string \| null	—	ความผันผวนของเกม เช่น HIGH
└ has_demo	boolean	—	มีโหมดทดลองเล่นหรือไม่
└ sort_order	number	—	ลำดับแสดงผลที่แนะนำ
└ maintenance_until	string \| null	—	เวลาที่ปิดปรับปรุงถึง (หาก null = ให้บริการปกติ)
pagination	object	—	ข้อมูลการแบ่งหน้า
└ page	number	—	หน้าปัจจุบัน
└ limit	number	—	จำนวนต่อหน้า
└ total	number	—	จำนวนเกมทั้งหมดที่ตรงเงื่อนไข
└ total_pages	number	—	จำนวนหน้าทั้งหมด

ตัวอย่าง response

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": {
    "data": [
      {
        "id": "3f8c2a71-5b9e-4d26-8a4f-c1e7d9b0a253",
        "provider_id": "b7a3e6c2-1f4d-4e8a-9c5b-2d7f8a1e3b6c",
        "provider": {
          "code": "PGSOFT",
          "name": "PG Soft",
          "logo_url": "https://cdn.example.com/providers/pgsoft.png"
        },
        "code": "mahjong-ways2",
        "name": "ไพ่นกกระจอก 2 (Mahjong Ways 2)",
        "type": "SLOT",
        "thumbnail_url": "https://cdn.example.com/games/mahjong-ways2.png",
        "tags": ["POPULAR", "HOT"],
        "rtp": "96.95",
        "volatility": "HIGH",
        "has_demo": true,
        "sort_order": 1,
        "maintenance_until": null
      },
      {
        "id": "8b2d4f6a-1c3e-4a5b-9d7f-0e2a4c6b8d1f",
        "provider_id": "b7a3e6c2-1f4d-4e8a-9c5b-2d7f8a1e3b6c",
        "provider": {
          "code": "PGSOFT",
          "name": "PG Soft",
          "logo_url": "https://cdn.example.com/providers/pgsoft.png"
        },
        "code": "treasures-aztec",
        "name": "สาวถ้ำแอซเท็ค (Treasures of Aztec)",
        "type": "SLOT",
        "thumbnail_url": "https://cdn.example.com/games/treasures-aztec.png",
        "tags": ["POPULAR"],
        "rtp": "96.71",
        "volatility": "HIGH",
        "has_demo": true,
        "sort_order": 2,
        "maintenance_until": null
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 812,
      "total_pages": 17
    }
  },
  "request_uuid": "9f2b7d1e-4a83-4c1f-b2ce-6d5a0e8f3c21"
}

Error codes ที่พบได้

code	ชื่อ	HTTP	ข้อความ
4001	VALIDATION_ERROR	400	ข้อมูลไม่ถูกต้องพารามิเตอร์ไม่ถูกต้อง เช่น category/tag นอกชุดที่รองรับ, page < 1, limit > 100
4002	BAD_REQUEST	400	คำขอไม่ถูกต้องระบุ agent ของ request ไม่ได้ (ไม่รู้จักโดเมน/credential)