Πρώτα βήματα

Όρια αιτημάτων

Κάθε χρήστης μπορεί να κάνει έως 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."
  }
}