Rate limits de l'API
Comprendre les quotas et les erreurs 429.
L'équipe Support Botillon 2 minMis à jour le 19 octobre 2026Publié le 18 octobre 2026
Les rate limits protègent Botillon et Discord contre les pics de requêtes. Ils s’appliquent aux endpoints publics et aux clés de projet. Une réponse 429 signifie que vous devez ralentir.
Limites principales
- API authentifiée : environ 120 requêtes en rafale et 240 requêtes par minute.
- Endpoints publics : limite par adresse IP.
- MCP : limite par IP, en lecture seule.
- Création de clés : limitée à quelques clés par heure.
Les valeurs exactes peuvent évoluer. La réponse 429 et l’en-tête Retry-After font foi.
Que faire en cas de 429
- Lisez
Retry-After. - Attendez le nombre de secondes indiqué.
- Réessayez avec un backoff exponentiel.
- Réduisez la fréquence ou regroupez les appels.
- Mettez en cache les réponses stables.
Bonnes pratiques
- Ne bouclez pas sans délai.
- Utilisez la pagination au lieu de tout demander.
- Mettez en cache les fiches et les tags.
- Regroupez les mises à jour de métadonnées.
- Surveillez les erreurs 429 dans vos logs.
Dépannage
- 429 immédiat : vous avez dépassé la rafale.
- 429 après quelques requêtes : la limite par minute est atteinte.
- 401 : clé absente ou invalide.
- 403 : projet non autorisé.
- 500 : erreur serveur ; réessayez avec prudence.
Voir aussi
Cet article vous a-t-il aidé ?
Votre avis aide à améliorer la documentation.
Passer à la pratique
Ouvrez la page concernée dans Botillon. La connexion Discord est demandée si nécessaire.
Besoin d’aide ?
Une erreur dans l’article, un réglage introuvable ou un problème de compte : ouvrez un ticket support avec l’URL de cette page.