Passer au contenu principal

Vue d’ensemble

Cet endpoint permet de mettre à jour le nom, le plafond, les modèles autorisés, l’expiration ou le statut d’une API Key existante.

Corps de la requête

Au moins un champ doit être fourni dans la requête PATCH.
ChampTypeValeurs par défaut / limitesDescription
statusenum-active, inactive, revoked
namestringlongueur 1-50Nom affiché mis à jour
limitAmountnumber | nullmin. 0, max. 100000null = illimité, 0 = aucun budget exploitable
limitCurrencyenumvaleur par défaut USDOptionnel : USD ou CNY. Si défini sur CNY, limitAmount est interprété en RMB puis converti en USD côté serveur avant le stockage
modelsstring[]-Liste d’autorisation des modèles logiques mise à jour
expiresAtstring | nulldatetime RFC3339null efface la date d’expiration

Notes

  • Le hard delete n’est volontairement pas pris en charge dans Management API v1.
  • revoked est généralement traité comme un état terminal. Si vous avez de nouveau besoin d’une clé, il vaut mieux en créer une nouvelle.
  • Par défaut, limitAmount est interprété en USD. Si vous envoyez limitCurrency: "CNY", le plafond est traité en RMB puis converti automatiquement en USD avec le taux de change actuel avant d’être stocké.
  • La réponse inclut exchange_rate ainsi que les champs d’affichage RMB limit_amount_cny et used_amount_cny.

Exemple

curl -X PATCH "https://api.lemondata.cc/v1/management/api-keys/key_abc123def456" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "inactive",
    "limitAmount": 0
  }'

Requête / Réponse

Utilisez le panneau OpenAPI interactif ci-dessus pour obtenir le schéma exact et les champs de réponse.