Kode status HTTP apa saja yang dikembalikan?
Setiap kesalahan membawa status HTTP dan kode kesalahan yang stabil. Buat percabangan berdasarkan kode, bukan berdasarkan pesan.
Setiap respons kesalahan memiliki kode error dan pesan yang ditulis untuk manusia. Kodenya adalah:
- 400 invalid_parameter: parameter tidak dikenal, formatnya salah, atau di luar rentang
- 400 invalid_cursor: kursor formatnya salah, sudah kedaluwarsa, atau diterbitkan untuk kunci lain atau filter lain
- 401 unauthenticated: tidak ada kunci yang dikirim, atau kunci tidak dikenali atau telah dicabut
- 403 ip_not_allowed, key_paused, country_not_entitled, atau upgrade_required: lihat “Mengapa saya menerima kesalahan 403?”
- 404 not_found: path tidak ada
- 405 method_not_allowed: setiap endpoint adalah GET
- 429 rate_limited atau quota_exceeded: tunggu selama periode Retry-After
- 500 internal_error: coba lagi nanti
- 503 not_configured atau service_unavailable: coba lagi nanti
Kode baru dapat ditambahkan. Perlakukan kode yang tidak Anda kenali sebagai kegagalan sesuai status HTTP yang menyertainya.