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
Phần tiêu đề “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. Giới hạn theo giây và theo phút được áp dụng đồng thời, và các header phản hồi báo cáo giới hạn theo phút.
Khi bạn chạm giới hạn
Phần tiêu đề “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 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.
Nếu các yêu cầu từ cùng một địa chỉ IP liên tục xác thực không thành công (hơn 30 lần trong 60 giây), các yêu cầu tiếp theo từ IP đó sẽ nhận 429 bất kể dùng token nào.