> 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/vi/developers/api/rate-limiting.md).

# Giới hạn tần suất

> Cách BoxHero API giới hạn tần suất yêu cầu theo nhóm và cách tạm dừng rồi thử lại.

Để dịch vụ luôn ổn định cho mọi người, BoxHero API giới hạn số yêu cầu mà một nhóm có thể gửi.

## Giới hạn áp dụng theo nhóm

Mọi API token thuộc cùng một nhóm dùng chung một giới hạn. Cấp thêm token trong một nhóm không làm tăng giới hạn.

## Khi bạn chạm giới hạn

API phản hồi `429` kèm [cấu trúc phản hồi lỗi](https://www.boxhero.io/docs/vi/developers/api/errors) có `type` là `/errors/too-many-requests`. Các header phản hồi cho biết khi nào bạn có thể thử lại:

| Header | Mô tả |
| --- | --- |
| `Retry-After` | Số giây cần chờ trước khi thử lại |
| `RateLimit`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` | Giới hạn hiện tại, số yêu cầu còn lại và thời điểm giới hạn được đặt lại |

Tạm dừng và thử lại sau khoảng thời gian trong `Retry-After`. Nếu bạn gửi nhiều yêu cầu liên tiếp, hãy giãn chúng ra thay vì gửi tất cả cùng lúc.

> **Note**
>
> Giới hạn có thể thay đổi. Hãy đọc giới hạn từ header phản hồi thay vì cố định tần suất trong mã client.