Gérer les clés API

Créez, gérez et révoquez des clés API pour vos intégrations externes. Utilisez-les pour vous authentifier auprès de l'API REST Bugalou.

Présentation

Les clés API vous permettent d'intégrer Bugalou à des systèmes externes et à des applications sur mesure. Elles servent à authentifier les requêtes vers toutes les API REST Bugalou, que vous envoyiez des modèles WhatsApp, gériez des commandes ou suiviez des factures. Accédez à Paramètres de l'organisation → API et intégrations. Les clés API et l'API REST sont disponibles avec le forfait Enterprise.

Créer une clé API

  1. Cliquez sur « Créer une clé API » en haut à droite
  2. Saisissez un nom pour la clé (par ex. « API de production », « Environnement de test »)
  3. Cliquez sur « Créer la clé »
  4. La clé complète s'affiche une seule fois dans une carte verte : copiez-la immédiatement ! Cliquez sur « Copier », puis sur « J'ai enregistré ma clé »

Important : la clé complète ne s'affiche qu'une fois. Après confirmation, seul le préfixe (bg_live_••••••••) reste visible.

Gérer les clés

Chaque carte de clé API affiche :

  • Nom — le nom que vous avez choisi pour la clé
  • Badge de statut — « Active » (vert) ou « Désactivée » (gris)
  • Préfixe — clé masquée : bg_live_••••••••
  • Créée le — date de création
  • Dernière utilisation — date du dernier appel API effectué avec la clé

Actions sur les clés

  • Désactiver / Activer — désactivez temporairement une clé sans la supprimer
  • Révoquer — supprimez définitivement la clé (avec fenêtre de confirmation)

Authentification

Incluez votre clé API dans chaque requête selon l'une des deux méthodes :

  • X-API-Key: bg_live_your_key_here — en-tête personnalisé
  • Authorization: Bearer bg_live_your_key_here — jeton Bearer

Les deux méthodes fonctionnent sur tous les endpoints de l'API.

Bonnes pratiques de sécurité

  • Ne partagez jamais votre clé API dans des dépôts de code publics
  • Utilisez des variables d'environnement pour stocker les clés dans vos applications
  • Créez des clés distinctes pour les environnements de production et de test
  • Désactivez ou révoquez les clés dont vous n'avez plus besoin
  • Renouvelez régulièrement vos clés : créez une nouvelle clé, mettez à jour vos intégrations, puis révoquez l'ancienne

API disponibles

Une fois que vous disposez d'une clé API, vous pouvez utiliser les API REST suivantes :

Vous ne trouvez pas ce que vous cherchez ?

Posez-nous directement votre question et vous recevrez une réponse personnelle.

Poser votre question