ข้อผิดพลาด

ข้อผิดพลาดใช้โครงสร้างเดียวกัน (ดูภาพรวม) ให้แยกเงื่อนไขตาม code บันทึก meta.request_id และถือว่า message เป็นข้อความภาษาอังกฤษสำหรับมนุษย์อ่าน

ข้อผิดพลาดฝั่งไคลเอนต์

รหัส	สถานะ	ความหมายและสิ่งที่ควรทำ
validation_failed	400	ฟิลด์ไม่ผ่านการตรวจสอบ field ระบุชื่อฟิลด์ details อธิบาย แก้ไขฟิลด์
bad_request	400	อ่านคำขอไม่ได้เลย: JSON ผิดรูปแบบ สตรีม Content-Encoding เสีย เนื้อหาถูกตัดกลางคัน ไม่มีฟิลด์ให้แก้ ตรวจสอบการส่งข้อมูล
validation_error	400	ส่ง X-Account-Id ไปยังเอนด์พอยต์ที่ห้ามใช้ (/auth/login /auth/refresh /auth/swap-company /auth/logout)
cursor_expired	400	เคอร์เซอร์การแบ่งหน้าเก่ากว่า 24 ชั่วโมง เริ่มดึงรายการใหม่
unauthenticated	401	ไม่มีโทเค็นหรือโทเค็นไม่ถูกต้อง รีเฟรชเซสชันหรือตรวจสอบคีย์
invalid_signature	401	ลายมือชื่อเว็บฮุกไม่ผ่านการตรวจสอบ ดูเว็บฮุก
forbidden	403	โทเค็นถูกต้องแต่ไม่มีสิทธิ์
account_context_mismatch	403	X-Account-Id ไม่ตรงกับบัญชีของโทเค็น ข้อมูลบริษัทปัจจุบันฝั่งไคลเอนต์คลาดเคลื่อน ให้อ่านใหม่จากเซสชัน
not_found	404	ไม่มีทรัพยากรนี้หรือทรัพยากรเป็นของบัญชีหรือไซต์อื่น API ไม่แยกแยะสองกรณีนี้
conflict	409	สถานะขัดแย้ง: การล็อกแบบ optimistic ข้อจำกัดความไม่ซ้ำ หรือการกระทำที่ไม่อนุญาตในสถานะปัจจุบัน (เช่น เขียนลงบทสนทนาที่รวมแล้ว)
idempotency_key_conflict	409	ใช้ Idempotency-Key ซ้ำกับเนื้อหาที่ต่างกัน
payload_too_large	413	เนื้อหาเกินขีดจำกัดของกลุ่มเอนด์พอยต์นี้
unsupported_media_type	415	Content-Type ไม่ถูกต้อง
unprocessable	422	JSON ถูกต้อง แต่กฎทางธุรกิจปฏิเสธ (เช่น ช่วงเวลาจองอยู่นอกเวลาทำการ)
storage_quota_exceeded	422	บัญชีใช้พื้นที่จัดเก็บถึงขีดจำกัดของแผนแล้ว details มี used_bytes quota_bytes และ requested_bytes ให้ลบข้อมูลเพื่อเพิ่มพื้นที่หรืออัปเกรด
rate_limited	429	ชะลอลง ปฏิบัติตาม Retry-After และ details.retry_after_seconds

ข้อผิดพลาดฝั่งเซิร์ฟเวอร์

รหัส	สถานะ	ความหมายและสิ่งที่ควรทำ
internal_error	500	ความล้มเหลวที่ไม่คาดคิด ลองใหม่หนึ่งครั้ง แล้วติดต่อซัพพอร์ตพร้อม request_id
upstream_unavailable	502	เกตเวย์เข้าถึงบริการไม่ได้เลย ลองใหม่อีกครั้งในเวลาสั้นๆ มักสำเร็จ
service_unavailable	503	การบำรุงรักษาตามแผนหรือ circuit breaker เปิดอยู่ ลองใหม่หลังเวลาในเฮดเดอร์ Retry-After
ai_vendor_out_of_funds	503	ผู้ให้บริการ AI ของคุณปฏิเสธการเรียกด้วยเหตุผลด้านการเรียกเก็บเงิน (402 หรือ 429 ด้านโควตาจากผู้ให้บริการ) เติมเงินในบัญชีผู้ให้บริการ การลองใหม่ไม่ช่วย
upstream_timeout	504	บริการไม่ตอบกลับทันเวลา ลองใหม่เมื่อมี retry_after

การลองใหม่

ลองใหม่สำหรับ 429 502 503 504 และความล้มเหลวของเครือข่าย ด้วยการเว้นระยะแบบเอ็กซ์โพเนนเชียล และส่ง Idempotency-Key เดิมในการลองใหม่ เพื่อไม่ให้การเขียนถูกนำไปใช้ซ้ำสองครั้ง อย่าลองใหม่สำหรับ 4xx อื่นนอกจาก 429