Les clés API vous donnent un accès programmatique à vos données Bigmind. Vous aurez besoin d'une clé API pour intégrer Bigmind avec vos applications, exécuter des scripts automatisés ou créer des intégrations personnalisées.
#Qu'est-ce qu'une clé API ?
Une clé API est un identifiant unique qui authentifie votre application lors de requêtes vers l'API Bigmind. Considérez-la comme un mot de passe—elle prouve que vous avez la permission d'accéder aux données de votre organisation de manière programmatique.
#Créer votre première clé API
Voici comment générer une clé API :
- Accéder aux paramètres — Cliquez sur votre avatar en haut à droite et sélectionnez "Paramètres"
- Accéder aux clés API — Dans la barre latérale des paramètres, trouvez et cliquez sur "Clés API"
- Créer une nouvelle clé — Cliquez sur le bouton "Créer une clé API" en haut à droite
- Nommer votre clé (optionnel) — Donnez un nom descriptif à votre clé comme "API Production" ou "Clé Développement" pour vous aider à l'identifier plus tard
- Cliquer sur Créer — Votre nouvelle clé API sera générée
#Copier votre clé API
C'est important : Lorsque votre clé API est créée, vous la verrez affichée une seule fois. Une fois cette boîte de dialogue fermée, vous ne pourrez plus voir la clé complète.
Pour sauvegarder votre clé :
- Cliquez sur le bouton "Copier" à côté de votre clé API
- Stockez-la dans un endroit sécurisé (comme un gestionnaire de mots de passe ou des variables d'environnement)
- Cliquez sur "J'ai copié la clé" une fois que vous l'avez sauvegardée
#Bonnes pratiques de sécurité
Vos clés API ont un accès complet aux données de votre organisation. Protégez-les :
- Ne partagez jamais les clés API publiquement — Ne les committez pas dans des dépôts Git et ne les partagez pas dans des messages de chat
- Utilisez des variables d'environnement — Stockez les clés dans des variables d'environnement, pas dans votre code
- Faites tourner les clés régulièrement — Supprimez les anciennes clés et créez-en de nouvelles périodiquement
- Utilisez des clés séparées par environnement — Créez différentes clés pour le développement, le staging et la production
- Supprimez les clés inutilisées — Si vous n'utilisez plus une clé, supprimez-la immédiatement
#Utiliser votre clé API
Incluez votre clé API dans l'en-tête Authorization de vos requêtes API :
Authorization: Bearer sk_your_api_key_herePar exemple, en utilisant curl :
curl https://api.bigmind.com/v1/meetings \
-H "Authorization: Bearer sk_your_api_key_here"#Gérer les clés API
Vous pouvez voir toutes vos clés API dans la page Paramètres > Clés API. Chaque clé affiche :
- Nom — Le nom descriptif que vous lui avez donné
- Aperçu de la clé — Une version masquée de la clé (sk_••••••••••••••••••••••••••••••••)
- Date de création — Quand la clé a été générée
- Dernière modification — Quand la clé a été modifiée pour la dernière fois
#Supprimer une clé API
Si vous devez révoquer l'accès ou supprimer une clé inutilisée :
- Survolez la clé API dans le tableau
- Cliquez sur le bouton "Supprimer" qui apparaît
- Confirmez la suppression
Attention : Une fois que vous supprimez une clé API, toutes les applications utilisant cette clé cesseront immédiatement de fonctionner. Cette action ne peut pas être annulée.
#Que faire si votre clé est compromise
Si vous avez accidentellement exposé votre clé API ou suspectez qu'elle a été compromise :
- Supprimez immédiatement la clé compromise — Allez dans Paramètres > Clés API et supprimez-la
- Créez une nouvelle clé — Générez une clé de remplacement avec un nouveau nom
- Mettez à jour vos applications — Remplacez l'ancienne clé par la nouvelle dans votre code
- Surveillez les activités inhabituelles — Vérifiez vos journaux d'utilisation de l'API pour toute requête suspecte
#Besoin d'aide ?
Si vous rencontrez des difficultés avec les clés API ou avez besoin d'aide pour intégrer l'API Bigmind, contactez notre équipe de support ou consultez notre documentation API.