Error
Setiap error dijawab sebagai problem details (RFC 9457) dengan
Content-Type: application/problem+json, apa pun endpoint-nya, termasuk
endpoint yang tidak ada.
{
"type": "about:blank",
"title": "Bad Request",
"status": 400,
"detail": "unknown column \"nama\"",
"param": "sort"
}
| Field | Arti |
|---|---|
type | Selalu about:blank; tidak ada katalog jenis error. |
title | Teks status HTTP. |
status | Kode status HTTP, sama dengan status respons. |
detail | Penjelasan untuk dibaca orang; jangan dicocokkan secara program. |
param | Hanya pada 400 karena query: parameter query string yang bermasalah. |
Status
| Status | Kapan |
|---|---|
| 400 | Parameter query tidak sah: kolom tidak dikenal, operator tidak berlaku untuk tipenya, nilai salah format, parameter berulang. |
| 401 | Tidak ada API key, atau key tidak dikenal atau sudah dicabut. Membawa header WWW-Authenticate. |
| 403 | Key sah tetapi tidak memiliki scope yang diperlukan endpoint ini. |
| 404 | Endpoint tidak ada, atau tidak ada baris dengan key itu. |
| 429 | Rate limit per menit terlampaui. Membawa header Retry-After (detik). |
| 500 | Error di sisi API; laporkan ke pengelola platform beserta waktu kejadian. |
| 503 | Tabel serving belum tersedia: pipeline pertama belum berjalan. Coba lagi nanti. |
Aplikasi sebaiknya bercabang pada status, menampilkan detail kepada
pengembang (bukan pengguna akhir), dan pada 429 menunggu selama
Retry-After sebelum mencoba lagi.