> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/id/developers/api/rate-limiting.md).

# 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.

## Batas berlaku per tim

Semua token API milik tim yang sama berbagi batas yang sama. Menerbitkan lebih banyak token di satu tim tidak menaikkan batasnya.

## Saat Anda mencapai batas

API merespons dengan `429` dan [amplop error](https://www.boxhero.io/docs/id/developers/api/errors.md) yang `type`-nya adalah `/errors/too-many-requests`. Header respons memberi tahu kapan Anda dapat mencoba lagi:

| Header | Deskripsi |
| --- | --- |
| `Retry-After` | Jumlah detik yang perlu ditunggu sebelum mencoba ulang |
| `RateLimit`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` | Batas 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.

> **Note**
>
> Batas dapat berubah. Baca batas dari header respons alih-alih menetapkan laju secara tetap di klien Anda.