Giới hạn tỷ lệ
Cập nhật lần cuối: 2026-07-06
Giới hạn tỷ lệ
HaMi Code Việt áp dụng giới hạn tỷ lệ để bảo vệ hệ thống khỏi lạm dụng. Giới hạn được thực thi qua Cloudflare Durable Objects, đảm bảo nhất quán toàn cầu.
Bảng giới hạn
| Endpoint | Giới hạn |
|---|---|
| Đăng nhập | 10 / 10 phút / IP, 5 / 15 phút / email |
| Đăng ký | 5 / giờ / IP, 3 / giờ / email |
| Quên mật khẩu | 3 / giờ / IP, 3 / giờ / email |
| Gửi lại xác minh | 3 / giờ / tài khoản |
| OAuth Google | 30 / 10 phút / IP |
| Khai báo người giám hộ | 5 / ngày / IP, 3 / ngày / người học |
| Hành động người giám hộ | 10 / giờ / tài khoản |
| Cấp đồng thuận | 20 / giờ / tài khoản |
| Thanh toán checkout | 10 / 10 phút / tài khoản |
| Thanh toán capture | 10 / 10 phút / tài khoản |
| Admin write | 60 / phút / tài khoản |
| Form liên hệ | 5 / giờ / IP |
| Tin nhắn AI | 30 / phút / tài khoản |
| Tạo hội thoại AI | 10 / giờ / tài khoản |
| GDPR deletion | 3 / giờ / tài khoản |
| Yêu cầu hoàn tiền | 5 / giờ / tài khoản |
| Tạo nội dung | 20 / giờ / tài khoản |
| Nộp code (CodeLab) | 30 / phút / tài khoản |
| API chung | 100 / phút / IP |
Header phản hồi
X-RateLimit-Limit— Giới hạn tối đaX-RateLimit-Remaining— Số yêu cầu còn lạiX-RateLimit-Reset— Thời gian reset (Unix timestamp)
Khi bị giới hạn
Khi vượt giới hạn, API trả về HTTP 429 với body:
{
"error": "rate_limited",
"message": "Quá nhiều yêu cầu.",
"retryAfter": 60
}Đợi retryAfter giây rồi thử lại.