Guide : Outils et API
Commandes slash, clés API et intégrations partenaires.
L’onglet Outils & API rassemble les fonctions techniques du projet : commandes slash, clé API, intégrations partenaires et accès aux statistiques. Il s’adresse aux développeurs qui veulent automatiser la fiche ou connecter Botillon à un autre service.
Les blocs de l’onglet
Commandes slash
Importez un fichier JSON de commandes pour les afficher sur la fiche publique. Les commandes restent déclaratives : Botillon ne les exécute pas.
Clé API
Créez une clé blp_… liée à un seul bot. Elle permet de lire les compteurs, les votes, les likes, les avis et de mettre à jour les métadonnées de la fiche. Elle ne permet pas de voter, liker ou publier un avis.
Intégrations partenaires
Connectez des services approuvés via un handshake et des webhooks signés. Les événements vote, like et commentaire peuvent être transmis à un partenaire.
Utiliser l’API
- Créez une clé dans Clé API du projet.
- Copiez-la immédiatement : elle n’est affichée qu’une fois.
- Envoyez-la dans l’en-tête
Authorization: Bearer blp_…. - Appelez les endpoints documentés sur la documentation API.
- Surveillez les quotas et les erreurs.
Bonnes pratiques
- Une clé par environnement, jamais dans un dépôt public.
- Révoquez une clé compromise.
- Utilisez HTTPS.
- Ne stockez pas la clé dans le code client.
- Testez avec des requêtes limitées.
Dépannage
- 401 : clé absente, invalide ou révoquée.
- 403 : la clé n’a pas accès à ce bot.
- 429 : quota dépassé, respectez
Retry-After. - Commande absente : vérifiez le JSON et la limite de 300 commandes.
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.