Serving API

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"
}
FieldArti
typeSelalu about:blank; tidak ada katalog jenis error.
titleTeks status HTTP.
statusKode status HTTP, sama dengan status respons.
detailPenjelasan untuk dibaca orang; jangan dicocokkan secara program.
paramHanya pada 400 karena query: parameter query string yang bermasalah.

Status

StatusKapan
400Parameter query tidak sah: kolom tidak dikenal, operator tidak berlaku untuk tipenya, nilai salah format, parameter berulang.
401Tidak ada API key, atau key tidak dikenal atau sudah dicabut. Membawa header WWW-Authenticate.
403Key sah tetapi tidak memiliki scope yang diperlukan endpoint ini.
404Endpoint tidak ada, atau tidak ada baris dengan key itu.
429Rate limit per menit terlampaui. Membawa header Retry-After (detik).
500Error di sisi API; laporkan ke pengelola platform beserta waktu kejadian.
503Tabel 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.