API-Schlüssel aktualisieren

Aktiviert/deaktiviert einen Schlüssel oder setzt/löscht sein Ausgabenlimit — jeder Aufruf tut genau eines davon, niemals beides gleichzeitig. Ein Management-Endpunkt mit derselben Regel wie bei der Schlüsselerstellung: Das Bearer-Token muss ein Management API Key sein, oder eine angemeldete Sitzung wird verwendet.

PATCH/api/v1/keys/:id

Autorisierung

Authorizationerforderlich

string · header

API-Schlüssel als Bearer-Token im Authorization-Header.

Pfadparameter

iderforderlich

string

Die ID des zu aktualisierenden Schlüssels.

Body

enabled

boolean

Aktiviert (true) oder deaktiviert (false) diesen Schlüssel. Jedes manuelle Umschalten löscht ein zuvor gesetztes Auto-Deaktivierungs-Flag wegen Ausgabenlimit, sodass der Schlüssel später nie stillschweigend gegen Ihre Absicht automatisch reaktiviert wird.

spendLimitUsd

number | null

Setzt das Ausgabenlimit in USD; übergeben Sie null, um das Limit zu löschen. Schließt sich mit enabled gegenseitig aus — eine einzelne Anfrage kann nur eines von beiden senden.

positive, ≤1,000,000

spendLimitPeriod

string | null

Reset-Zeitraum für das Ausgabenlimit. Erforderlich, wenn spendLimitUsd gesetzt ist, und akzeptiert nur die rohen Werte day/week/month — im Gegensatz zum Erstellungs-Endpunkt werden die Aliase daily/weekly/monthly hier NICHT akzeptiert.

dayweekmonth

PATCH /api/v1/keys/:id

1
2
3
4
curl -X PATCH https://bazaarlink.ai/api/v1/keys/key_abc123 \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Antwortbeispiele

Aktualisiert. Die Antwort ist nur ein Bestätigungs-Flag, nicht der vollständige Schlüsseldatensatz — rufen Sie erneut die Schlüsselliste auf, um den aktuellen Zustand zu sehen.

1
2
3
{
  "updated": true
}