शुरुआत करें

अनुरोधों की सीमा

हर उपयोगकर्ता प्रति मिनट 120 अनुरोध तक भेज सकता है, जिसमें उसकी सभी कुंजियाँ मिलाकर गिनी जाती हैं। काउंटर घड़ी के हर नए मिनट पर शून्य हो जाता है।

मान्य कुंजी वाले रिस्पॉन्स इन हेडर में खपत दिखाते हैं:

नाम	प्रकार	विवरण
`X-RateLimit-Limit`	`integer`	प्रति मिनट अनुमत अनुरोध।
`X-RateLimit-Remaining`	`integer`	मौजूदा मिनट में कितने अनुरोध बाकी हैं।
`X-RateLimit-Reset`	`integer`	काउंटर शून्य होने में बचे सेकंड।
`Retry-After`	`integer`	केवल `429` रिस्पॉन्स में: दोबारा प्रयास करने से पहले आपको कितने सेकंड रुकना है।

सीमा पार होने पर रिस्पॉन्स 429 होता है, जिसका कोड rate_limited होता है। दोबारा प्रयास करने से पहले Retry-After में दिया गया समय पूरा होने दें।

मान्य कुंजी के बिना किए गए प्रयास (बिना कुंजी, गलत कुंजी या निरस्त कुंजी के साथ) हर IP पते के लिए प्रति मिनट 30 तक सीमित हैं।

सीमा तक न पहुँचने के लिए

कम अनुरोधों में ज़्यादा आइटम पाने के लिए 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."
  }
}