Giới hạn truy cập
Thông tin về rate limits và cách xử lý khi bị giới hạn
iNET API áp dụng giới hạn truy cập để đảm bảo chất lượng dịch vụ cho tất cả người dùng.
Các mức giới hạn
| Tier | Requests/Phút | Requests/Giờ | Requests/Ngày | Burst |
|---|---|---|---|---|
| Free | 60 | 1,000 | 10,000 | 5 |
| Basic | 300 | 5,000 | 50,000 | 15 |
| Pro | 1,000 | 20,000 | 200,000 | 50 |
| Enterprise | 5,000 | 100,000 | 1,000,000 | 200 |
- Burst: Số request tối đa trong 1 giây
- Tài khoản mới mặc định là tier Free
Response Headers
Mỗi response đều trả về headers cho biết trạng thái rate limit:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1711900800
| Header | Mô tả |
|---|---|
| X-RateLimit-Limit | Số request tối đa trong khung thời gian |
| X-RateLimit-Remaining | Số request còn lại |
| X-RateLimit-Reset | Thời điểm reset (Unix timestamp) |
Khi bị giới hạn (429 Too Many Requests)
Khi vượt giới hạn, API trả về:
JSON
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Bạn đã vượt giới hạn truy cập. Vui lòng thử lại sau."
}
}
Cách xử lý
1. Retry với Exponential Backoff
for i in 1 2 3; do
HTTP_CODE=$(curl -s -o /tmp/res.json -w "%{http_code}" \
-H "Authorization: Bearer inet_sk_your_key" "$URL")
[ "$HTTP_CODE" != "429" ] && break
sleep $((2**i))
done2. Cache kết quả
Nếu bạn gọi cùng 1 endpoint nhiều lần với cùng tham số, hãy cache kết quả ở phía client để giảm số request.