Kode status berikut dapat ditampilkan dalam respons HTTP.
Kode HTTP | Deskripsi HTTP | Catatan |
---|---|---|
2xx | Oke | Bukan error; ditampilkan jika berhasil. Kode ini juga harus digunakan untuk kegagalan logika bisnis (misalnya booking_failure di CreateBookingResponse telah diisi) |
400 | Permintaan Tidak Valid | Permintaan Buruk/Argumen Tidak Valid (penjual, layanan, slot tidak ditemukan, mencoba memesan slot yang tidak valid, membatalkan pemesanan yang tidak pernah ada). |
401 | Tidak diotorisasi | Tidak diautentikasi (kredensial tidak valid, coba lagi login). Permintaan tidak memiliki kredensial autentikasi yang valid untuk operasi. |
403 | Terlarang | Izin ditolak/terlarang (pemanggil dikenal dan ditolak). Respons ini tidak boleh digunakan untuk penolakan yang disebabkan oleh kehabisan beberapa resource (sebagai gantinya, gunakan Too Many Requests untuk error tersebut).
Forbidden tidak boleh digunakan jika pemanggil tidak dapat
diidentifikasi (sebagai gantinya, gunakan Unauthorized untuk error tersebut). |
404 | Tidak Ditemukan | Tidak ditemukan (Sumber daya tidak ditemukan, url tidak valid, termasuk RPC tidak valid) |
409 | Konflik | Operasi dibatalkan, biasanya karena masalah serentak seperti kegagalan pemeriksaan sequencer atau pembatalan transaksi. |
429 | Terlalu Banyak Permintaan | Beberapa resource telah habis, mungkin kuota per pengguna, atau mungkin kapasitas keseluruhan sistem file sudah habis. |
499 | Klien Menutup Permintaan | Operasi dibatalkan, biasanya oleh pemanggil. |
500 | Error Server Internal | Error internal. Artinya, beberapa invarian yang diharapkan oleh sistem yang mendasarinya telah rusak. Kode error ini disediakan untuk error yang serius. |
501 | Tidak Diterapkan | Operasi tidak diterapkan atau tidak didukung/diaktifkan dalam layanan ini. |
503 | Layanan Tidak Tersedia | Saat ini layanan tidak tersedia. Kemungkinan besar ini hanya kondisi sementara, yang dapat dikoreksi dengan mencoba kembali dengan backoff. |
504 | Waktu Tunggu Gateway Habis | Batas waktu berakhir sebelum operasi selesai. Untuk operasi yang mengubah status sistem, error ini dapat ditampilkan meskipun operasi telah berhasil diselesaikan. Misalnya, respons yang berhasil dari server dapat tertunda cukup lama hingga batas waktu berakhir. |
Terkadang beberapa kode error mungkin berlaku. Layanan harus menampilkan kode error paling spesifik yang berlaku.