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.

API phản hồi 429 kèm cấu trúc phản hồi lỗi 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.