Aller au contenu principal

Clés API

Les clés API sont nécessaires pour authentifier les requêtes adressées aux API GPT Translator.

Sur cette page​

Avant de commencer​

Assurez-vous de disposer des éléments suivants :

  1. Un compte GPT Translator.
  2. Un accès au tableau de bord API.
  3. Un environnement côté serveur pour stocker vos clés en toute sécurité.

Créer une clé API​

  1. Connectez-vous à votre compte GPT Translator.
  2. Ouvrez Clés API pour développeurs dans le tableau de bord.
  3. Cliquez sur Générer une nouvelle clé API.
  4. Copiez immédiatement la clé générée.
  5. Stockez-la dans une variable d’environnement de votre backend (par exemple : .env).

Utiliser votre clé API​

Envoyez votre clé dans l’en-tête de la requête :

x-api-key: YOUR_API_KEY

Gestion des clés​

  • Régénérer la clé: renouvelle les identifiants et invalide la clé précédente.
  • Supprimer la clé: désactive définitivement l’accès à l’API pour cette clé.
  • Source de référence unique: suivez les clés actives dans votre gestionnaire de secrets.

Bonnes pratiques de sécurité​

Important

N’exposez jamais de clés API dans le code frontend, les bundles du navigateur ou des dépôts publics.

  • Conservez les clés uniquement côté serveur.
  • Utilisez des variables d’environnement ou un gestionnaire de secrets.
  • Renouvelez les clés régulièrement ou après toute fuite suspectée.
  • Limitez les accès opérationnels aux actions de gestion des clés.
  • Surveillez régulièrement l’utilisation de l’API afin de détecter tout trafic inhabituel.

Erreurs courantes​

  • 401 Unauthorized : en-tête x-api-key absent ou non valide.
  • 403 Forbidden : la clé existe, mais l’accès n’est pas autorisé.
  • 429 Too Many Requests : la limite de débit des requêtes a été dépassée.

Étapes suivantes​