​

Authentification

​

Obtenir votre clé API

1. Connectez-vous à votre compte VoiceHire sur app.voicehire.io
2. Accédez aux paramètres de votre agence
3. Dans la section “API”, générez une nouvelle clé API
4. Copiez et conservez cette clé en lieu sûr

​

Utiliser votre clé API

curl -X GET https://app.voicehire.io/api/v1/campaigns \
  -H "X-API-Key: vh_live_VOTRE_CLE_API"

import httpx

headers = {
    "X-API-Key": "vh_live_VOTRE_CLE_API"
}

response = httpx.get(
    "https://app.voicehire.io/api/v1/campaigns",
    headers=headers
)

const response = await fetch('https://app.voicehire.io/api/v1/campaigns', {
  headers: {
    'X-API-Key': 'vh_live_VOTRE_CLE_API'
  }
});

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.voicehire.io/api/v1/campaigns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "X-API-Key: vh_live_VOTRE_CLE_API"
  ],
]);

$response = curl_exec($curl);

​

Format de la clé API

vh_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX

• Préfixe vh_live_ pour les clés de production
• 32+ caractères aléatoires

​

Erreurs d’authentification

{
  "error": {
    "code": "MISSING_API_KEY",
    "message": "API key is required",
    "details": {
      "header": "X-API-Key"
    }
  }
}

​

Codes d’erreur possibles

​

Sécurité

​

Bonnes pratiques

• Variables d’environnement : Stockez votre clé API dans des variables d’environnement
• Rotation régulière : Changez votre clé API régulièrement
• Restrictions IP : Limitez l’accès à des IP spécifiques (contactez le support)
• HTTPS uniquement : Toutes les requêtes doivent utiliser HTTPS

​

Exemple avec variables d’environnement

import os
import httpx

# Charger la clé depuis l'environnement
api_key = os.getenv('VOICEHIRE_API_KEY')

headers = {
    "X-API-Key": api_key
}

# Utiliser la clé
response = httpx.get(
    "https://app.voicehire.io/api/v1/campaigns",
    headers=headers
)

​

Limites et quotas

• Requêtes par minute : 60
• Requêtes par heure : 1000
• Taille max de requête : 10 MB