Bắt đầu

Giới hạn yêu cầu

Mỗi người dùng có thể gửi tối đa 120 yêu cầu mỗi phút, tính gộp tất cả các khóa của người dùng đó. Bộ đếm được đặt lại vào đầu mỗi phút theo đồng hồ.

Phản hồi cho một khóa hợp lệ cho biết mức sử dụng trong các header sau:

Khi vượt giới hạn, phản hồi là 429 với mã rate_limited. Hãy chờ hết thời gian trong Retry-After rồi mới thử lại.

Để không chạm giới hạn

• Dùng per_page tối đa 100 để lấy nhiều mục hơn với ít yêu cầu hơn.
• Để theo dõi trạng thái TV, một yêu cầu mỗi phút là đủ.
• Với các tác vụ lớn, hãy phân bổ yêu cầu theo thời gian và theo dõi X-RateLimit-Remaining.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42

HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 18 seconds."
  }
}