Quotas#

Une limite par minute et par clé, annoncée dans chaque réponse.

Chaque clé dispose d'un quota de requêtes par minute (fenêtre glissante), défini avec ELRM à sa création, 60 par défaut, 300 pour la clé du bac à sable émise à la réinitialisation. Au-delà, les appels répondent 429 rate_limited jusqu'à ce que la fenêtre se libère.

En-têtes#

Toute réponse d'une requête authentifiée porte :

En-tête	Contenu
`X-RateLimit-Limit`	Quota de la clé, par minute
`X-RateLimit-Remaining`	Appels restants dans la fenêtre courante
`X-RateLimit-Reset`	Secondes avant que la fenêtre se libère (fenêtre glissante d'une minute : toujours `60`, le pire cas)
`Retry-After`	Sur `429` uniquement : secondes à attendre

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 60
Retry-After: 60

{ "error": "rate_limited" }

Bien se comporter#

Lisez X-RateLimit-Remaining et ralentissez avant le 429 plutôt qu'après.
Sur 429, attendez Retry-After secondes ; n'ajoutez pas de tentatives immédiates, elles comptent dans le quota.
Pour suivre un dossier, préférez le journal des événements avec since (une requête renvoie tout ce qui s'est passé) à une lecture répétée du dossier. Voir Suivre un dossier.
Une synchronisation de catalogue n'a pas besoin de tourner plus d'une fois par heure : le catalogue change rarement.

Si votre usage légitime dépasse le quota, parlez-en à ELRM : il se règle par clé.