Créer une clé API
Générer, nommer et révoquer une clé API.
Une clé API permet à votre bot de lire ses statistiques et de mettre à jour ses métadonnées depuis un script. Elle est liée à un seul projet et ne permet jamais de voter, liker ou publier un avis.
Créer la clé
- Ouvrez l’onglet Outils & API du projet.
- Dans Clé API du projet, cliquez sur Créer une clé.
- Donnez-lui un nom utile, par exemple
productionoudashboard. - Copiez la clé immédiatement : elle n’est affichée qu’une fois.
- Stockez-la dans un gestionnaire de secrets.
Une nouvelle clé révoque l’ancienne clé active du projet. Prévoyez la mise à jour de vos scripts avant de régénérer.
Format
Une clé ressemble à blp_ suivi de 48 caractères hexadécimaux, soit 52 caractères. Elle s’utilise dans l’en-tête :
Authorization: Bearer blp_votre_cle
Ce que la clé permet
- Lire l’identité du projet et les compteurs.
- Lire les votes, likes, avis et commandes.
- Mettre à jour les métadonnées de la fiche.
- Accéder aux endpoints
/api/v1/me/*.
Ce qu’elle ne permet pas
- Voter, liker ou publier un avis.
- Gérer l’équipe.
- Supprimer le bot.
- Accéder aux données d’un autre projet.
Sécurité
- Ne mettez jamais la clé dans un dépôt public.
- Ne la mettez pas dans une URL.
- Révoquez-la immédiatement si elle fuite.
- Utilisez une clé par environnement.
- Surveillez la date de dernier usage.
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.