Rate Limiting
Nâng cao
Cập nhật: 22/03/2026
Rate Limiting
API ThueAPI.VN áp dụng giới hạn request để đảm bảo hiệu suất cho tất cả người dùng.
Giới hạn
| API | Giới hạn | Cửa sổ |
|---|---|---|
| GET /api/v1/transactions | 60 requests | 1 phút |
| GET /api/v1/bank-accounts | 60 requests | 1 phút |
| POST /api/webhooks/pay2s | Không giới hạn | — |
Response khi vượt giới hạn
HTTP 429 Too Many Requests
{
"message": "Too many requests. Please try again later.",
"retry_after": 30
}
Headers
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
Retry-After: 30
Best Practices
- Cache kết quả API thay vì gọi lại liên tục
- Sử dụng webhook để nhận giao dịch mới thay vì polling
- Implement exponential backoff khi nhận 429