ออกจากระบบ

ใช้งานได้

POST/api/v1/auth/logout

ลงชื่อออกจากระบบ refresh token และ access token ปัจจุบันจะใช้งานไม่ได้ทันที

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

Request bodyapplication/json

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
refresh_token	string	—	refresh token ที่ต้องการ revoked

Response

ฟิลด์ใน data

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
revoked	boolean	—	true เสมอ — endpoint นี้ idempotent แม้ token หาย/หมดอายุก็ถือว่าออกจากระบบสำเร็จ

ตัวอย่าง response

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": {
    "revoked": true
  },
  "request_uuid": "a92c4e17-8b53-4d06-9e71-3f5b0d8c2a64"
}

Error codes ที่พบได้

code	ชื่อ	HTTP	ข้อความ
9003	TOO_MANY_REQUESTS	429	คำขอมากเกินไป กรุณาชะลอความเร็วเกิน rate limit ของกลุ่ม auth (10 ครั้ง/นาที/IP)