Effectuer votre premier appel API #
Bienvenue dans l’API REST de VoxPria! Ce guide vous accompagne pour effectuer votre premier appel API en seulement quelques minutes.
Ce dont vous aurez besoin #
- Un compte VoxPria (inscrivez-vous ici)
- Une clé API (nous vous montrerons comment en créer une)
- Un outil pour effectuer des requêtes HTTP (curl, Postman, ou votre langage de programmation préféré)
Démarrage rapide en 3 étapes #
Étape 1 : Obtenez votre clé API #
- Connectez-vous à app.voxpria.com
- Accédez à Paramètres → Clés API
- Cliquez sur « Créer une nouvelle clé API »
- Donnez-lui un nom (p. ex. « Ma première clé API »)
- Sélectionnez les portées :
calls:readetcalls:write - Copiez votre clé API immédiatement!
Étape 2 : Effectuez votre premier appel API #
Obtenez votre solde de crédits à l’aide de curl :
curl -X GET "https://app.voxpria.com/api/v1/credits" -H "Authorization: Bearer YOUR_API_KEY_HERE" -H "Content-Type: application/json"
Étape 3 : Comprenez la réponse #
{
"success": true,
"data": {
"balance": 1500,
"currency": "credits"
}
}
Codes de réponse #
| Code | Signification | Action |
|---|---|---|
200 |
Succès | ✅ Ça fonctionne! |
401 |
Non autorisé | Vérifiez la clé API |
403 |
Interdit | Vérifiez les portées |
429 |
Limite de débit atteinte | Ralentissez |
Essayez le terrain de jeu API #
Prochaines étapes #
- Authentification – Apprenez-en davantage sur la sécurité de l’API
- Référence API – Explorez tous les points de terminaison
- Exemples de code – Consultez des exemples dans votre langage
