Premiers pas

Limite de requêtes

Chaque utilisateur peut effectuer jusqu'à 120 requêtes par minute, toutes ses clés confondues. Le compteur est remis à zéro à chaque changement de minute.

Les réponses à une clé valide indiquent votre consommation dans ces en-têtes :

Nom	Type	Description
`X-RateLimit-Limit`	`integer`	Requêtes autorisées par minute.
`X-RateLimit-Remaining`	`integer`	Requêtes restantes dans la minute en cours.
`X-RateLimit-Reset`	`integer`	Secondes avant la remise à zéro du compteur.
`Retry-After`	`integer`	Uniquement dans la réponse `429` : secondes à attendre avant de réessayer.

Au-delà de la limite, la réponse est 429 avec le code rate_limited. Attendez le délai indiqué dans Retry-After avant de réessayer.

Les tentatives sans clé valide (sans clé, avec une clé erronée ou révoquée) sont limitées à 30 par minute et par adresse IP.

Pour ne pas atteindre la limite

Utilisez per_page jusqu'à 100 pour récupérer plus d'éléments avec moins de requêtes.
Pour suivre le statut des TVs, une requête par minute suffit.
Pour les traitements volumineux, répartissez les requêtes dans le temps et surveillez X-RateLimit-Remaining.

En-têtes d'une réponse200

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

Limite atteinte429

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