Authentification API
Envoyer la clé API dans l'en-tête Authorization.
L’API Botillon utilise une clé de projet dans l’en-tête Authorization. Les endpoints publics de lecture ne demandent pas de clé, mais les routes /api/v1/me/* sont réservées au projet lié.
En-tête
Authorization: Bearer blp_votre_cle
La clé doit être envoyée à chaque requête authentifiée. Elle ne doit jamais être placée dans l’URL ni dans un paramètre de requête.
Première requête
curl -H "Authorization: Bearer $BOTILLON_API_KEY" \
https://botillon.fr/api/v1/me
La réponse contient l’identité du bot, les compteurs et la fenêtre de vote.
Erreurs courantes
| Code | Cause | Solution |
|---|---|---|
| 401 | Clé absente, invalide ou révoquée | Vérifiez l’en-tête et régénérez la clé |
| 403 | Clé d’un autre projet | Utilisez la clé du bot concerné |
| 404 | Ressource inconnue | Vérifiez l’identifiant ou le slug |
| 429 | Quota dépassé | Attendez Retry-After |
Bonnes pratiques
- Stockez la clé dans une variable d’environnement.
- Utilisez HTTPS.
- Ne loggez jamais la clé complète.
- Révoquez une clé compromise.
- Utilisez une clé par environnement.
Endpoints publics
Les routes /api/v1/bots, /bots/{id}, /bots/{id}/stats, /bots/{id}/community et /users/{id} sont publiques et limitées par IP. Elles ne permettent aucune écriture.
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.