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

# Limitation de débit

> Découvrez les limites de débit de l'API Qwoty

Notre API implémente une limitation de débit pour garantir une utilisation équitable et protéger le système contre les abus. Cette page détaille nos politiques de limitation de débit et comment les gérer efficacement.

## Limites de débit

| Type d'opération                    | Limite |     Fenêtre |
| ----------------------------------- | -----: | ----------: |
| Lecture (GET)                       |    200 | 10 secondes |
| Écriture (POST, PUT, PATCH, DELETE) |     50 | 10 secondes |

## En-têtes de limitation de débit

Les réponses de l'API incluent les en-têtes de limitation de débit suivants :

* `X-RateLimit-Limit` : Le nombre maximum de requêtes autorisées dans la fenêtre actuelle
* `X-RateLimit-Remaining` : Le nombre de requêtes restantes dans la fenêtre actuelle
* `X-RateLimit-Reset` : La date et l'heure auxquelles la fenêtre de limitation de débit se réinitialise
* `Retry-After` : Le nombre minimum de secondes à attendre avant de réessayer (uniquement lorsque la limite a été atteinte)

## Gestion des limites de débit

Lorsque vous dépassez la limite de débit, l'API retourne un code de statut HTTP **429 Too Many Requests**. Le corps de la réponse sera :

```text theme={null}
Too many requests
```

## Bonnes pratiques

1. **Surveiller les limites de débit :** Suivez l'en-tête `X-RateLimit-Remaining` pour anticiper quand vous approchez de la limite.
2. **Implémenter un recul :** Lorsque vous recevez une réponse 429 :
   * Attendez jusqu'à la date spécifiée dans l'en-tête `X-RateLimit-Reset`.
   * Envisagez d'implémenter un recul exponentiel pour les nouvelles tentatives.
3. **Regrouper les requêtes :** Lorsque c'est possible, combinez plusieurs opérations en une seule requête.
4. **Mise en cache :** Mettez en cache les réponses lorsque cela est approprié pour réduire le nombre d'appels API.

## Exemples d'en-têtes de réponse

### Limite de débit non dépassée

```http theme={null}
HTTP/1.1 200 OK
X-RateLimit-Limit: 200
X-RateLimit-Remaining: 150
X-RateLimit-Reset: 2025-04-15T10:18:08.107Z
```

### Limite de débit dépassée

```http theme={null}
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 200
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2025-04-15T10:18:08.107Z
Retry-After: 5
```

## Limites de débit personnalisées

Si votre application nécessite des limites de débit plus élevées, veuillez contacter notre équipe d'assistance. Nous travaillerons avec vous pour établir des limites appropriées en fonction de votre cas d'utilisation.