Batas dan error
Rate limit, kode error, dan pagination.
#Batas permintaan
| Jenis akses | Batas |
|---|---|
| Key developer | 300 permintaan per menit per key |
| Key config server | 120 permintaan per menit per key |
Tanpa key (jika api.public aktif) | 120 permintaan per menit per IP |
Saat batas terlampaui kamu mendapat 429 dan header Retry-After berisi jumlah detik menunggu.
#Kode error
| Kode | Kapan muncul |
|---|---|
400 | Parameter atau ID tidak valid. |
401 | API key tidak ada, salah, atau sudah dicabut (saat API tidak publik). |
403 | Endpoint hanya untuk key developer, tetapi key yang dipakai berasal dari config server. |
404 | Data tidak ditemukan. |
429 | Batas permintaan terlampaui (300/menit untuk key developer, 120/menit untuk lainnya), atau terlalu banyak key salah. Lihat header Retry-After. |
502 | Database sedang bermasalah. Coba lagi nanti. |
503 | API belum diaktifkan di config.json, atau database belum dikonfigurasi. |
Semua error berbentuk:
{ "error": "Pesan yang bisa dibaca manusia" }#Pagination
Daftar berita memakai cursor. Kirim next_cursor dari respons sebelumnya sebagai before. Kalau next_cursor bernilai null, itu halaman terakhir.
#Cache
Respons memakai Cache-Control: no-store karena isinya bergantung pada key. Simpan hasil di sisi aplikasimu kalau datanya jarang berubah.