Lewati ke konten

Batas permintaan

Cara BoxHero API membatasi laju permintaan per tim serta cara menunda dan mencoba ulang.


Agar layanan tetap stabil untuk semua pengguna, BoxHero API membatasi jumlah permintaan yang dapat dikirim oleh satu tim.

Semua token API milik tim yang sama berbagi batas yang sama. Menerbitkan lebih banyak token di satu tim tidak menaikkan batasnya. Batas per detik dan per menit berlaku bersamaan, dan header respons melaporkan batas per menit.

API merespons dengan 429 dan amplop error yang type-nya adalah /errors/too-many-requests. Header respons memberi tahu kapan Anda dapat mencoba lagi:

HeaderDeskripsi
Retry-AfterJumlah detik yang perlu ditunggu sebelum mencoba ulang
RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetBatas saat ini, sisa permintaan, dan kapan batas diatur ulang

Tunda lalu coba ulang setelah waktu yang tertera di Retry-After. Jika Anda mengirim banyak permintaan berturut-turut, sebarkan permintaan tersebut alih-alih mengirim semuanya sekaligus.

Jika permintaan dari alamat IP yang sama berulang kali gagal diautentikasi (lebih dari 30 kali dalam 60 detik), permintaan berikutnya dari IP tersebut menerima 429 apa pun tokennya.