צעדים ראשונים

מגבלת בקשות

כל משתמש יכול לשלוח עד 120 בקשות לדקה, בסך הכול בכל המפתחות שלו. המונה מתאפס בתחילת כל דקה עגולה בשעון.

תגובות למפתח תקין מציגות את הצריכה בכותרות האלה:

שם	סוג	תיאור
`X-RateLimit-Limit`	`integer`	מספר הבקשות המותר לדקה.
`X-RateLimit-Remaining`	`integer`	כמה בקשות נותרו בדקה הנוכחית.
`X-RateLimit-Reset`	`integer`	מספר השניות עד שהמונה מתאפס.
`Retry-After`	`integer`	רק בתגובת `429`: מספר השניות שיש להמתין לפני ניסיון נוסף.

מעבר למגבלה, התגובה היא 429 עם הקוד rate_limited. יש להמתין את הזמן שמופיע ב-Retry-After לפני ניסיון נוסף.

ניסיונות ללא מפתח תקין (בלי מפתח, עם מפתח שגוי או עם מפתח שתוקפו בוטל) מוגבלים ל-30 לדקה לכל כתובת IP.

כדי לא להגיע למגבלה

אפשר להשתמש ב-per_page עד 100 כדי לקבל יותר פריטים בפחות בקשות.
כדי לעקוב אחר סטטוס הטלוויזיות, מספיקה בקשה אחת לדקה.
במשימות גדולות, כדאי לפזר את הבקשות לאורך זמן ולעקוב אחר X-RateLimit-Remaining.

כותרות של תגובה200

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

המגבלה מוצתה429

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."
  }
}