Limites de débit et mise en cache

Combien de requêtes vous pouvez envoyer, les en-têtes qui vous l’indiquent et ce qu’il faut mettre en cache.

120 requêtes par minute

Chaque adresse peut envoyer 120 requêtes par minute à l’API publique. Le décompte repart au début de chaque minute de l’horloge ; RateLimit-Reset indique combien de secondes il reste d’ici là.

Des en-têtes qui indiquent où vous en êtes

Chaque réponse contient RateLimit-Limit, le nombre de requêtes autorisées par la fenêtre ; RateLimit-Remaining, le nombre restant ; et RateLimit-Reset, le nombre de secondes avant que la fenêtre ne recommence.

HTTP

RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 20

En cas de dépassement

Une requête au-delà de la limite répond 429 rate_limited avec un en-tête Retry-After en secondes. Attendez ce délai avant la requête suivante ; en envoyer d’autres entre-temps ne raccourcit pas l’attente.

HTTP

HTTP/1.1 429 Too Many Requests
Retry-After: 37

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Wait and try again."
}

Conservez une copie

Les données du catalogue changent au plus quelques fois par jour. Stockez les réponses que vous utilisez et actualisez-les à intervalles réguliers au lieu de les redemander pour chaque visiteur. Certaines réponses portent un en-tête Cache-Control qui indique combien de temps elles restent à jour.