Aller au contenu principal

Authentification

Les points de terminaison pour développeurs de GVR sont protégés par une clé API.

URL de base​

https://api.genderrecognition.com

En-tête​

Envoyez votre clé dans l’en-tête apiKey :

apiKey: YOUR_API_KEY

Le serveur lit cet en-tête sous le nom apikey. La casse de l’en-tête n’a donc pas d’importance avec les clients HTTP habituels.

Exemple​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api/name" \
  -H "Content-Type: application/json" \
  -H "apiKey: YOUR_API_KEY" \
  -d '{
  "firstName": "Alex",
  "lastName": "Morgan"
}'

En cas d’échec de l’authentification​

Clé API manquante​

{
  "error": "API key is required"
}

Clé API invalide​

{
  "error": "Invalid API key"
}

Erreur interne d’authentification​

{
  "error": "Internal server error"
}

Une requête peut également échouer lorsque :

  • le quota de la clé est épuisé
  • le corps de la requête ne passe pas la validation
  • le fichier envoyé est absent, trop volumineux ou dans un format non pris en charge

La page de chaque point de terminaison répertorie les erreurs propres à cette API.

Gardez vos clés secrètes et remplacez-les si elles sont divulguées.