Zum Hauptinhalt springen

​
Überblick

Mit diesem Endpunkt aktualisieren Sie Name, Limit, erlaubte Modelle, Ablaufzeit oder Status eines vorhandenen API-Keys.

​
Request-Body

Mindestens ein Feld muss in der PATCH-Anfrage angegeben werden.
FeldTypStandard / GrenzenBeschreibung
statusenum-active, inactive, revoked
namestringLänge 1-50Aktualisierter Anzeigename
limitAmountnumber | nullmin. 0, max. 100000null = unbegrenzt, 0 = kein nutzbares Budget
limitCurrencyenumStandard USDOptional: USD oder CNY. Wenn CNY gesetzt ist, wird limitAmount als RMB interpretiert und serverseitig vor dem Speichern in USD umgerechnet
modelsstring[]-Aktualisierte Allowlist für logische Modelle
expiresAtstring | nullRFC3339-Datetimenull entfernt die Ablaufzeit

​
Hinweise

  • Hard Delete wird in Management API v1 bewusst nicht unterstützt.
  • revoked ist in der Praxis ein Endzustand. Wenn erneut Zugriff benötigt wird, ist ein neuer Key meist die bessere Wahl.
  • Standardmäßig wird limitAmount als USD interpretiert. Wenn du limitCurrency: "CNY" sendest, wird das Limit als RMB behandelt und vor dem Speichern automatisch mit dem aktuellen Wechselkurs in USD umgerechnet.
  • Die Antwort enthält exchange_rate sowie die RMB-Anzeigefelder limit_amount_cny und used_amount_cny.

​
Beispiel

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
  }'

​
Anfrage / Antwort

Verwenden Sie das interaktive OpenAPI-Panel oben für das genaue Schema und die Response-Felder.