Démarrage rapide

Suivez le Guide d’authentification pour vous connecter, puis ouvrez la page Clés de gestion et créez une clé de gestion. Stockez-la séparément des clés d’application standard. Envoyez-la en tant que jeton Bearer uniquement aux points de terminaison de gestion de la plateforme.

Une clé API standard ne peut pas appeler les points de terminaison de gestion des clés ou des garde-fous. Une clé de gestion valide peut tout de même recevoir 403 Forbidden si son propriétaire ne dispose plus du rôle de compte requis.

Utilisez GET /api/v1/keys pour inspecter les clés visibles par le compte de la clé de gestion :

Utilisez les identifiants publics retournés pour les requêtes ultérieures de récupération, de mise à jour, de révocation ou d’attribution de guardrails. Ne déduisez jamais les accès à partir d’un nom de clé ou d’un jeton masqué.

Créez une clé d’application avec POST /api/v1/keys. Le secret complet n’est retourné que dans la réponse de création ; persistez-le dans votre gestionnaire de secrets avant de supprimer cette réponse. La rotation doit créer un remplacement, le déployer dans l’application, vérifier le trafic, puis révoquer l’ancienne clé.

credit_limit_windows accepte toute combinaison de plafonds de dépenses glissants 1h, 1d et 7d. Si une fenêtre configurée est épuisée, les appels avec cette clé retournent 429 Too Many Requests jusqu’à ce que l’utilisation quitte la fenêtre. Envoyez un objet vide lors de la mise à jour d’une clé pour effacer tous les plafonds glissants.

Les guardrails sont des politiques de compte réutilisables pour les contrôles de modèle, de fournisseur et de dépenses. Gérez les politiques via /api/v1/guardrails, puis utilisez /api/v1/guardrail_assignments pour les attacher ou les supprimer. Traitez une assignation rejetée comme un échec de politique ou de propriété plutôt que de continuer silencieusement sans le guardrail.