Giới hạn tần suất truy cập API (Rate Limit)

Tổng quan

iNET API áp dụng giới hạn tần suất truy cập (rate limiting) để đảm bảo chất lượng dịch vụ cho tất cả người dùng.

Mức giới hạn hiện tại

Lưu ý: mọi API key hiện đều áp dụng chung một mức giới hạn này. Các gói với hạn mức cao hơn chưa được triển khai.

Header phản hồi

Mỗi phản hồi từ API đều kèm theo các header thể hiện trạng thái rate limit theo cửa sổ phút:

• X-RateLimit-Limit: số request tối đa trong 1 phút
• X-RateLimit-Remaining: số request còn lại trong phút hiện tại
• X-RateLimit-Reset: thời điểm reset của cửa sổ phút (Unix timestamp)

Và theo cửa sổ ngày:

• X-RateLimit-Limit-Day: số request tối đa trong 1 ngày
• X-RateLimit-Remaining-Day: số request còn lại trong ngày hiện tại

Lỗi khi vượt giới hạn (429)

Khi vượt giới hạn, API trả về HTTP 429 kèm thông báo: "Bạn đã gửi quá nhiều yêu cầu, vui lòng chờ và thử lại". Phản hồi 429 kèm thêm header Retry-After (số giây cần chờ trước khi gọi lại).

Khuyến nghị xử lý

• Exponential Backoff Retry: áp dụng cơ chế thử lại với độ trễ tăng dần, có thể dựa vào header Retry-After
• Client-Side Caching: lưu lại kết quả của các request lặp lại cùng tham số để giảm số lần gọi API