> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wappfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Limites de debit

> Politiques de limitation de debit de l'API et comment gerer les erreurs de limitation.

# Limites de debit

L'API Wappfy applique des limites de debit pour garantir une utilisation equitable et la stabilite de la plateforme.

## Limites par defaut

| Portee                   | Limite       | Fenetre  |
| ------------------------ | ------------ | -------- |
| Par utilisateur          | 100 requetes | 1 minute |
| Par IP (non authentifie) | 20 requetes  | 1 minute |

## En-tetes de limitation de debit

Chaque reponse inclut des informations sur les limites de debit :

```http theme={null}
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1707580800
```

| En-tete                 | Description                                           |
| ----------------------- | ----------------------------------------------------- |
| `X-RateLimit-Limit`     | Nombre maximum de requetes autorisees dans la fenetre |
| `X-RateLimit-Remaining` | Requetes restantes dans la fenetre en cours           |
| `X-RateLimit-Reset`     | Horodatage Unix de la reinitialisation de la fenetre  |

## Gestion des limites de debit

Lorsque vous depassez la limite, vous recevrez une reponse `429` :

```json theme={null}
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests, please try again later"
  }
}
```

### Bonnes pratiques

<AccordionGroup>
  <Accordion title="Implementez un backoff exponentiel">
    Lorsque vous recevez un 429, attendez et reessayez avec des delais croissants : 1s, 2s, 4s, 8s...
  </Accordion>

  <Accordion title="Utilisez l'en-tete Reset">
    Consultez `X-RateLimit-Reset` pour savoir exactement quand vous pouvez reprendre.
  </Accordion>

  <Accordion title="Regroupez les operations lorsque c'est possible">
    Envoyez les messages avec des delais raisonnables entre eux plutot que de les envoyer en rafale.
  </Accordion>

  <Accordion title="Mettez en cache les reponses">
    Evitez de recuperer a nouveau des donnees qui n'ont pas change (par ex., details d'instance, infos de contact).
  </Accordion>
</AccordionGroup>