Apakah kod status HTTP yang dikembalikan?
Setiap ralat membawa status HTTP dan kod ralat yang stabil. Buat keputusan berdasarkan kod, bukan berdasarkan mesej.
Setiap respons ralat mempunyai kod error dan mesej yang ditulis untuk manusia. Kod-kodnya ialah:
- 400 invalid_parameter: parameter tidak dikenali, formatnya salah atau di luar julat
- 400 invalid_cursor: kursor formatnya salah, telah tamat tempoh atau dikeluarkan untuk kunci lain atau penapis lain
- 401 unauthenticated: tiada kunci dihantar, atau kunci tidak dikenali atau telah dibatalkan
- 403 ip_not_allowed, key_paused, country_not_entitled atau upgrade_required: lihat “Mengapakah saya menerima ralat 403?”
- 404 not_found: laluan tidak wujud
- 405 method_not_allowed: setiap titik akhir ialah GET
- 429 rate_limited atau quota_exceeded: tunggu selama tempoh Retry-After
- 500 internal_error: cuba lagi kemudian
- 503 not_configured atau service_unavailable: cuba lagi kemudian
Kod baharu mungkin ditambah. Anggap kod yang tidak anda kenali sebagai kegagalan mengikut status HTTP yang disertakan bersamanya.