Comment créer une clé API #
Suivez ce guide étape par étape pour créer votre clé API VoxPria en moins de 2 minutes.
Étape 1 : Accéder à la page des clés API #
- Connectez-vous à app.voxpria.com
- Cliquez sur Paramètres dans la barre latérale
- Sélectionnez Clés API
📍 Emplacement : Paramètres → Clés API
Étape 2 : Créer une nouvelle clé #
- Cliquez sur le bouton « Créer une nouvelle clé API » (en haut à droite)
- Une boîte de dialogue apparaît
Étape 3 : Configurer votre clé #
Nom de la clé #
Donnez-lui un nom descriptif :
Bons exemples :
- « Serveur de production – Application principale »
- « Environnement de développement »
- « Intégration WordPress »
- « Connecteur CRM – Salesforce »
- « Automatisation marketing »
Portées de permission #
| Portée | Permet | Cas d’usage |
|---|---|---|
calls:read | Consulter les appels | Tableaux de bord |
calls:write | Déclencher des appels | Intégration CRM |
campaigns:read | Consulter les campagnes | Analytique |
campaigns:write | Gérer les campagnes | Automatisation |
contacts:read | Consulter les contacts | Synchronisation des contacts |
contacts:write | Gérer les contacts | Importations |
webhooks:manage | Gérer les webhooks | Piloté par événements |
⚠️ Conseil de sécurité : N’accordez que les permissions réellement nécessaires (principe du moindre privilège).
Étape 4 : Générer la clé #
- Passez en revue la configuration
- Cliquez sur « Créer la clé API »
- La clé s’affiche
Étape 5 : Copier et conserver la clé #
🚨 CRITIQUE : C’est la SEULE fois que vous verrez la clé complète. Copiez-la MAINTENANT!
- Cliquez sur le bouton « Copier »
- Conservez-la dans un endroit sécurisé :
- Gestionnaire de mots de passe (1Password, LastPass, Bitwarden)
- Application de notes sécurisées
- Fichier de variables d’environnement
- Cliquez sur « Terminé »
Étape 6 : Vérifier que ça fonctionne #
curl -X GET "https://app.voxpria.com/api/v1/credits" -H "Authorization: Bearer YOUR_NEW_API_KEY" -H "Content-Type: application/json"
Gérer les clés #
Consulter les clés : #
Paramètres → Clés API affiche toutes les clés actives
Révoquer une clé : #
- Trouvez la clé dans la liste
- Cliquez sur « Révoquer »
- Confirmez l’action
- La clé est immédiatement désactivée
⚠️ Avertissement : La révocation ne peut pas être annulée. Les applications utilisant cette clé cesseront de fonctionner.
Bonnes pratiques #
- ✅ Des clés distinctes par environnement
- ✅ Des noms descriptifs
- ✅ Des permissions minimales
- ✅ Renouvelez tous les 90 jours
- ✅ Révoquez les clés inutilisées
- ❌ Ne jamais valider dans Git
- ❌ Ne jamais partager par courriel
- ❌ Ne jamais utiliser des clés de production en développement
Dépannage #
Boîte de dialogue fermée avant la copie? #
Malheureusement, vous devez :
- Révoquer la clé que vous avez créée
- En créer une nouvelle
- La copier avant de fermer!
Vous ne voyez pas le bouton Créer? #
- Vérifiez les permissions du compte
- Assurez-vous que le compte est en règle
- Contactez le soutien si vous avez atteint la limite de clés
