Passer au contenu principal

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.

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érationLimiteFenêtre
Lecture (GET)20010 secondes
Écriture (POST, PUT, PATCH, DELETE)5010 secondes

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

Les réponses 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 en cours
  • X-RateLimit-Remaining : le nombre de requêtes restantes dans la fenêtre en cours
  • X-RateLimit-Reset : la date et l’heure de réinitialisation de la fenêtre de limitation
  • Retry-After : le nombre minimum de secondes à attendre avant de réessayer (uniquement lorsque la limite est 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 : 
Too many requests

​
Bonnes pratiques

  1. Surveillez les limites de débit : suivez l’en-tête X-RateLimit-Remaining pour anticiper l’approche de la limite.
  2. Implémentez un backoff : lorsque vous recevez une réponse 429 :
    • Attendez la date spécifiée dans l’en-tête X-RateLimit-Reset.
    • Envisagez d’implémenter un backoff exponentiel pour les tentatives.
  3. Regroupez 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 c’est approprié pour réduire le nombre d’appels API.

​
Exemples d’en-têtes de réponse

​
Limite de débit non atteinte

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 atteinte

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 personnalisées

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