Créer et protéger une clé API GetAPI.ONE

Prérequis

• Connectez-vous à GetAPI.ONE et confirmez que vous pouvez ouvrir la console.
• Confirmez que le compte dispose d’un solde utilisable ou d’un forfait applicable.
• Déterminez l’unique client ou projet qui utilisera cette clé et l’emplacement où sa variable d’environnement secrète sera stockée.

• Se connecter
• Aide relative au compte

Créer la clé

1. Ouvrez Clés API depuis la navigation de la console et sélectionnez Créer une clé API.
2. Saisissez un nom descriptif, par exemple le client et l’environnement. N’inscrivez pas le secret lui-même dans le nom.
3. Choisissez le groupe requis pour le modèle et le point de terminaison prévus.
4. Définissez une clé, une expiration précise et un quota adapté à l’utilisation prévue. N’examinez les restrictions avancées que si le client en a besoin.
5. Enregistrez les modifications et revenez à la liste des clés.

• Ouvrir Clés API

Copier et stocker la clé

Après la création, la liste affiche le nom de la clé, sa valeur masquée, son groupe, son état et les actions de gestion. Sur GetAPI.ONE, la clé n’est pas révélée une seule fois : vous pouvez la copier de nouveau depuis la liste et continuer à la gérer.

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

Associer la clé à l’adresse ONE

Vérifier sans exposer la clé

1. Configurez un client ou suivez le guide de requête directe en remplaçant le modèle de substitution par une entrée de catalogue compatible avec le point de terminaison.
2. N’envoyez qu’une requête minimale dont vous acceptez la facturation ; aucune requête n’a été envoyée pendant la rédaction de ce guide.
3. Confirmez une réponse valide et consultez l’enregistrement de la requête ou de l’utilisation dans la console. Masquez la clé avant d’enregistrer les résultats de diagnostic.

• Requête API directe
• Codex CLI

Erreurs, rotation et révocation

• 401 / Unauthorized : copiez de nouveau la clé, supprimez tout espace accidentel, confirmez qu’elle est activée et vérifiez qu’elle est associée à l’adresse ONE.
• Modèle introuvable ou accès refusé : confirmez que le groupe de la clé donne accès au modèle et que celui-ci déclare le point de terminaison utilisé par votre client.
• Erreur de quota ou d’expiration : examinez la limite et l’expiration de la clé avant de les augmenter ; vérifiez également le solde du compte et les limites de débit.
• Suspicion de divulgation : désactivez ou supprimez la clé concernée, créez-en une autre avec la portée minimale nécessaire, mettez à jour le client et vérifiez que l’ancienne clé ne peut plus être utilisée.

• Dépannage
• Assistance