Limites de débit

Comment le débit de l’API se mesure, par équipe et en unités de coût, et comment s’y adapter.

Mis à jour le 3 octobre 2026

Le débit appartient à l’équipe, pas au jeton : tous les jetons d’une équipe partagent la même enveloppe, fixée par votre offre, par minute et par jour.

Des unités de coût

Chaque opération coûte un nombre d’unités, publié dans la référence : une lecture simple coûte 1, un rapport agrégé davantage. Chaque réponse porte son coût (X-Request-Cost) et l’état des fenêtres :

RateLimit-Policy et RateLimit (format IETF) ;
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset pour la fenêtre de la minute.

curl -i "https://api.nessflow.com/v1/usage" \
  -H "Authorization: Bearer $NESSFLOW_TOKEN"

GET /v1/usage rend aussi la consommation de chaque fenêtre et les quotas de votre offre.

Quand la limite est atteinte

L’API répond 429 rate_limited, avec l’en-tête Retry-After et, dans le corps, window (minute ou day), retry_after et upgrade_to, l’offre qui relèverait la limite. Attendez Retry-After secondes avant de réessayer.

Dépenser moins

Une requête refusée pour dépassement (429), ou qui répond 304, ne coûte rien.
Envoyez l’ETag reçu dans If-None-Match : une ressource inchangée répond 304, gratuitement.
Préférez les webhooks au sondage.