AgeviroDocs

Batas dan error

Rate limit, kode error, dan pagination.

#Batas permintaan

Jenis aksesBatas
Key developer300 permintaan per menit per key
Key config server120 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

KodeKapan muncul
400Parameter atau ID tidak valid.
401API key tidak ada, salah, atau sudah dicabut (saat API tidak publik).
403Endpoint hanya untuk key developer, tetapi key yang dipakai berasal dari config server.
404Data tidak ditemukan.
429Batas permintaan terlampaui (300/menit untuk key developer, 120/menit untuk lainnya), atau terlalu banyak key salah. Lihat header Retry-After.
502Database sedang bermasalah. Coba lagi nanti.
503API belum diaktifkan di config.json, atau database belum dikonfigurasi.

Semua error berbentuk:

json
{ "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.