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
- Cliquez sur « Créer une clé API » en haut à droite
- Saisissez un nom pour la clé (par ex. « API de production », « Environnement de test »)
- Cliquez sur « Créer la clé »
- 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 :
- API Modèles WhatsApp — envoyez des messages modèles par programmation
- API Commandes et e-commerce — gérez les commandes de boutiques en ligne et de systèmes sur mesure
- API Facturation et paiements — suivez factures, paiements et données financières