Aller au contenu principal

Clé API

Une clé API identifie le compte développeur qui envoie une requête aux API pour développeurs de GVR.

Gérer votre clé​

Créez, consultez, remplacez ou supprimez votre clé API depuis l’application GVR. Cette documentation explique comment utiliser une clé déjà disponible dans votre compte.

Utiliser une clé​

Envoyez votre clé aux points de terminaison pour développeurs dans l’en-tête apiKey :

apiKey: YOUR_API_KEY

Pour les requêtes JSON, ajoutez également l’en-tête de type de contenu JSON :

Content-Type: application/json
apiKey: YOUR_API_KEY

Pour envoyer un fichier, joignez la clé à la requête multipart.

Cycle de vie d’une clé​

Si une clé est remplacée ou supprimée dans l’application GVR, les requêtes qui utilisent l’ancienne clé échoueront avec :

{
  "error": "Invalid API key"
}

Conseils de sécurité​

  • Stockez les clés dans des variables d’environnement côté serveur.
  • N’enregistrez pas de clés dans un dépôt.
  • N’exposez pas de clés dans les fichiers publics de l’application cliente.
  • Si une clé est divulguée, remplacez-la depuis l’application GVR.