API ส่งคืนรหัสสถานะ HTTP ใดบ้าง
ข้อผิดพลาดทุกรายการมีสถานะ HTTP และรหัสข้อผิดพลาดที่คงที่ ให้แยกการทำงานตามรหัส ไม่ใช่ตามข้อความ
การตอบกลับที่เป็นข้อผิดพลาดแต่ละรายการมีรหัส error และข้อความที่เขียนให้คนอ่าน รหัสมีดังนี้
- 400 invalid_parameter: พารามิเตอร์ไม่รู้จัก ผิดรูปแบบ หรืออยู่นอกช่วงที่กำหนด
- 400 invalid_cursor: เคอร์เซอร์ผิดรูปแบบ หมดอายุ หรือออกให้กับคีย์อื่นหรือตัวกรองอื่น
- 401 unauthenticated: ไม่ได้ส่งคีย์ หรือคีย์ไม่เป็นที่รู้จักหรือถูกเพิกถอนแล้ว
- 403 ip_not_allowed, key_paused, country_not_entitled หรือ upgrade_required: ดูคำอธิบายในหัวข้อ “เหตุใดฉันจึงได้รับข้อผิดพลาด 403”
- 404 not_found: ไม่มีเส้นทางนี้อยู่
- 405 method_not_allowed: ทุกเอนด์พอยต์ใช้ GET
- 429 rate_limited หรือ quota_exceeded: รอให้ครบระยะเวลาที่ระบุไว้ใน Retry-After ก่อน
- 500 internal_error: ลองใหม่ภายหลัง
- 503 not_configured หรือ service_unavailable: ลองใหม่อีกครั้งในภายหลัง
อาจมีการเพิ่มรหัสใหม่ หากพบรหัสที่คุณไม่รู้จัก ให้ถือว่าเป็นความล้มเหลวตามสถานะ HTTP ที่มาพร้อมกับรหัสนั้น