Gestion programmée des API Keys
Consulter, créer, modifier et supprimer des API Keys avec un jeton d’accès.
Suivez ce guide pour automatiser la gestion des clés dans une application. Pour appeler un modèle ou configurer un SDK seulement, voir API Key et authentification.
Obtenir un jeton d’accès
Créez un jeton d’accès dans « Sécurité » sur la page Profil pour gérer les clés de cet utilisateur.
Les jetons d’accès et les API Keys de modèles ont des usages distincts : API de gestion : jeton d’accès ; API de modèles : API Key. Ne les mélangez pas.
Envoyer une première requête de gestion
Remplacez your-user-token par le jeton d’accès, puis demandez la liste des clés :
curl 'https://api.agtcloud.cn/api/token/?p=1&size=20' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-user-token'Après réussite, trouvez la clé dans data.items et conservez son id pour lire les détails, modifier ou supprimer. Sans enregistrements, items est vide.
Le champ key des listes/détails peut être masqué et ne convient pas aux appels de modèles. Consultez le secret complet sur API Keys.
Choisir une opération
Ouvrez la Reference correspondante pour les paramètres, les réponses ou le test en ligne.
| Opération | Usage |
|---|---|
| Lister les API Keys | Parcourir les clés par page |
| Rechercher des API Keys | Rechercher par nom ou valeur de clé |
| Obtenir une API Key | Lire la configuration par ID |
| Créer une API Key | Définir nom, quota, expiration et restrictions |
| Mettre à jour une API Key | Modifier la configuration ou seulement activer/désactiver |
| Supprimer une API Key | Supprimer une clé |
| Supprimer des API Keys par lot | Supprimer plusieurs clés |
Pour le quota restant d’une clé, utilisez Consulter le quota API Key avec cette clé, pas le jeton d’accès.
Précautions
Vérifier les cibles avant modification ou suppression
Une mise à jour ordinaire peut réinitialiser les champs omis. Lisez d’abord les détails, puis envoyez tous les réglages à conserver. Pour activer/désactiver seulement, utilisez le mode « état uniquement ».
La suppression affecte les applications utilisant la clé. Vérifiez l’ID cible et n’exécutez pas de suppression avec un ID d’exemple.
- Vérifier le résultat métier : HTTP
200peut contenir un échec. Vérifiez aussisuccessetmessage. - Éviter les écritures répétées : après expiration d’une création, modification ou suppression, vérifiez d’abord son application par une lecture ; ne renvoyez pas immédiatement.
- Protéger les jetons : conservez-les sur un serveur contrôlé, pas dans le frontend, les journaux publics, captures ou dépôts. Protégez aussi les URL de recherche contenant une clé.