Pakai katalog ini untuk menangani kegagalan umum secara konsisten.
Kesalahan validasi dan permintaan
| Status | Contoh detail | Arti | Tindakan |
|---|---|---|---|
400 |
channel_id is required |
Kolom yang diperlukan tidak ada | Perbaiki payload permintaan |
400 |
to is required |
Kolom penerima tidak ada | Tambahkan nomor tujuan |
400 |
type is required |
Jenis operasi pesan tidak ada | Tambahkan type |
400 |
content is required |
Konten pesan tidak ada | Tambahkan objek content |
400 |
invalid messageID |
ID jalur (Path ID) bukan UUID yang valid | Kirim UUID yang valid |
400 |
invalid conversation_id |
ID percakapan isi permintaan tidak valid | Perbaiki format ID |
Kesalahan autentikasi dan izin
| Status | Contoh detail | Arti | Tindakan |
|---|---|---|---|
401 |
missing user context |
Tidak ada kredensial autentikasi yang valid | Kirim header X-Api-Key |
401 |
invalid email or password |
Kredensial masuk tidak valid | Periksa kembali masukan masuk kamu |
403 |
forbidden |
Kredensial kurang memiliki izin | Pakai kredensial dengan cakupan/peran yang diperlukan |
Kesalahan sumber daya dan status
| Status | Contoh detail | Arti | Tindakan |
|---|---|---|---|
404 |
message not found |
Sumber daya tidak ada | Verifikasi pengidentifikasi dan konteks penyewa |
409 |
conflict |
Permintaan bertentangan dengan status saat ini | Segarkan status, lalu ulangi dengan aman |
429 |
rate limited |
Batas terlampaui | Lakukan backoff (tunda waktu) lalu ulangi |
500 |
internal server error |
Kegagalan backend yang tidak terduga | Ulangi dengan backoff dan catat log konteks permintaan |
Format respons
{
"title": "Bad Request",
"status": 400,
"detail": "channel_id is required"
}