ค่ายเกมแนะนำ

ใช้งานได้

GET/api/v1/games/providers/featured

แถว "ค่ายแนะนำ" ที่คัดสรรไว้สำหรับไซต์ของคุณ เรียงตาม position — ถ้ายังไม่ได้จัดชุดเอง จะได้ชุดแนะนำกลางของระบบ

ตอบเฉพาะค่ายที่เปิดให้ไซต์ของคุณจริง — ค่ายที่ปักหมุดไว้แต่ปิดใช้งานหรือไม่ได้ถือสิทธิ์ จะหายไปจากรายการเอง

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

Response

ฟิลด์ใน data

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
data[]	array<object>	—	รายการค่ายเกมแนะนำ เรียงตาม position
└ position	number	—	ตำแหน่งการจัดเรียง (เริ่มที่ 1)
└ provider	object	—	ข้อมูลค่ายเกม (โครงเดียวกับรายชื่อค่ายเกม)
└ id	string (uuid)	—	id ค่ายเกม — ใช้กรองรายการเกมผ่าน ?provider_id=
└ code	string	—	รหัสค่าย เช่น PGSOFT
└ name	string	—	ชื่อค่ายสำหรับแสดงผล
└ logo_url	string \| null	—	URL โลโก้ค่าย
└ categories	string[]	—	ประเภทเกมที่ค่ายนี้ให้บริการSLOT \| ARCADE \| LIVE_CASINO \| TABLE \| FISHING \| SPORT \| LOTTERY \| ESPORT \| KENO \| COCKFIGHT
└ game_count	number	—	จำนวนเกมของค่าย
└ launch_game_id	string \| null	—	ค่ายแบบเกมเดียว (game_count = 1 เช่น กีฬา/คาสิโนสด) → id เกมไว้เปิดจากการ์ดค่ายได้ทันที ไม่ต้องเรียกรายการเกม — null = ค่ายมีหน้ารายการเกม
└ maintenance_until	string \| null	—	เวลาที่ปิดปรับปรุงถึง (หาก null = ให้บริการปกติ)
└ sort_order	number	—	ลำดับแสดงผลที่แนะนำ

ตัวอย่าง response

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": [
    {
      "position": 1,
      "provider": {
        "id": "b7a3e6c2-1f4d-4e8a-9c5b-2d7f8a1e3b6c",
        "code": "PGSOFT",
        "name": "PG Soft",
        "logo_url": "https://cdn.example.com/providers/pgsoft.png",
        "categories": ["SLOT"],
        "game_count": 138,
        "launch_game_id": null,
        "maintenance_until": null,
        "sort_order": 1
      }
    },
    {
      "position": 2,
      "provider": {
        "id": "2c8e4a6b-9d1f-4b3a-a5c7-e0f2d4b6a8c1",
        "code": "SAGAME",
        "name": "SA Gaming",
        "logo_url": "https://cdn.example.com/providers/sagame.png",
        "categories": ["LIVE_CASINO"],
        "game_count": 1,
        "launch_game_id": "6e1d3b5f-7a9c-4e2b-8d0f-1a3c5e7b9d2f",
        "maintenance_until": null,
        "sort_order": 4
      }
    }
  ],
  "request_uuid": "9f2b7d1e-4a83-4c1f-b2ce-6d5a0e8f3c21"
}

Error codes ที่พบได้

code	ชื่อ	HTTP	ข้อความ
4002	BAD_REQUEST	400	คำขอไม่ถูกต้องระบุ agent ของ request ไม่ได้ (ไม่รู้จักโดเมน/credential)