Giới hạn tốc độ API
Mục đích
Mô tả rate limit theo chiều khách hàng & cửa sổ thời gian để tránh 60001.
Khái niệm
Chiều giới hạn
| Khóa | Tên | Mô tả |
|---|---|---|
| USER | Người dùng | Theo định danh người gọi |
| APP | Ứng dụng | Theo app gắn với API key |
| GLOBAL | Toàn cục | Trần toàn nền tảng |
Cửa sổ
| Khóa | Đơn vị |
|---|---|
| SECOND | 1 giây |
| MINUTE | 1 phút |
Hạn mức
Bất kỳ một ngưỡng nào vượt → bị chặn:
| Chiều | Cửa sổ | Giới hạn |
|---|---|---|
| USER | Giây | 100/s |
| USER | Phút | 5000/phút |
| APP | Giây | 20/s |
| APP | Phút | 1000/phút |
| GLOBAL | Giây | 3000/s |
| GLOBAL | Phút | 150000/phút |
Nguyên tắc chặt nhất thắng — ví dụ 101 req/giây là lỗi dù còn quota phút.
Khi bị chặn
- HTTP/body trả
60001(INTERFACE_RATE_LIMIT) - Chờ hết cửa sổ hiện tại để bộ đếm reset
Lưu ý
- Kể cả lỗi tham số / auth vẫn có thể tính vào quota xử lý cổng.
- Nên tự throttle phía client.
- Cần quota cao hơn — liên hệ vận hành nền tảng.
- Chính sách có thể đổi; theo dõi thông báo.