Budgets
Les budgets sont comptés par clé API et par classe de requête, sur une fenêtre glissante d’une minute. Toutes les clés d’un même utilisateur partagent en plus un plafond égal à 2 fois le budget d’une clé.
- « Simultanées » compte les requêtes HTTP en cours, pas les runs actifs.
POST /v1/runs répond en quelques millisecondes, donc cette limite gêne peu. POST /v1/go/run (synchrone) occupe un slot pendant toute la recherche.
- Avant l’authentification, chaque adresse IP est limitée à 100 requêtes par tranche de 10 secondes.
En-têtes
Les réponses authentifiées portent :
RateLimit-Reset est en secondes.
Réponse 429
Au-delà du budget, l’API répond 429 avec le code rate_limited et l’en-tête Retry-After (en secondes) :
Attendez Retry-After secondes, puis réessayez. Au-delà du parallélisme autorisé, Retry-After vaut 1.
Les valeurs peuvent être ajustées par l’équipe Retriever. Lisez les en-têtes plutôt que de coder les chiffres en dur.