# 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.

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.

```bash
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.