API-Schlüssel erstellen

Erstellt einen neuen Standard-API-Schlüssel (oder einen weiteren Management-Schlüssel). Ein Management-Endpunkt — bei Authentifizierung per Bearer-Token muss es sich um einen Management API Key handeln, nicht um einen gewöhnlichen sk-bl-Schlüssel; ein angemeldetes Session-Cookie funktioniert ebenfalls. Das key-Feld in der Antwort ist die einzige Gelegenheit, den rohen Schlüsselwert zu sehen — danach wird nur noch der Hash gespeichert und kann nicht erneut abgerufen werden.

POST/api/v1/keys

Autorisierung

Authorizationerforderlich

string · header

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

Body

nameerforderlich

string

Anzeigename für den Schlüssel; führende/nachgestellte Leerzeichen werden entfernt, das Ergebnis darf nicht leer sein.

≤200 chars, trimmed non-empty

keyType

string

Schlüsseltyp, Standard ist standard; jeder Wert außer "management" wird als standard behandelt.

standardmanagement

Example: "standard"

limit

number | null

Ausgabenlimit in USD, gespeichert als spendLimitUsd. null oder weggelassen bedeutet kein Limit. Wenn gesetzt, muss auch limit_reset angegeben werden. GET /v1/key gibt denselben Wert als limit zurück.

0–1,000,000

limit_reset

string | null

Reset-Zeitraum für das Ausgabenlimit, gespeichert als spendLimitPeriod. Akzeptiert entweder die OR-kompatiblen Aliase (daily/weekly/monthly) oder die internen Namen (day/week/month) — beide Formen sind gleichwertig.

dailyweeklymonthlydayweekmonth

Example: "monthly"

expires_at

string | null

Ablaufzeit des Schlüssels, ein ISO-Datumsstring, der in der Zukunft liegen muss. null oder weggelassen bedeutet, dass er nie abläuft.

Example: "2027-01-01T00:00:00Z"

organizationId

string | null

Bindet den Schlüssel an die angegebene Organisation statt an das persönliche Konto. Der Aufrufer muss die Autorisierungsprüfung für diesen Organisations-/Team-/Mitgliedsbereich bestehen, sonst liefert die Anfrage 400.

teamId

string | null

Schränkt den Schlüssel weiter auf ein bestimmtes Team innerhalb der Organisation ein. Wird zusammen mit organizationId verwendet.

orgMemberId

string | null

Schränkt den Schlüssel weiter auf ein bestimmtes Mitglied innerhalb der Organisation ein. Wird zusammen mit organizationId verwendet.

POST /api/v1/keys

1
2
3
4
curl https://bazaarlink.ai/api/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "production", "limit": 50, "limit_reset": "monthly"}'

Antwortbeispiele

Erstellt. Das key-Feld ist der vollständige Rohwert und wird nur in dieser einen Antwort angezeigt — speichern Sie ihn sofort, da er später, selbst vom Aufrufer, nicht mehr abgerufen werden kann.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "id": "key_abc123",
  "name": "production",
  "key": "sk-bl-AbCdEfGh...",
  "keyType": "standard",
  "prefix": "sk-bl-",
  "enabled": true,
  "spendLimitUsd": 50,
  "spendLimitPeriod": "month",
  "expiresAt": null,
  "createdAt": "2026-07-27T00:00:00.000Z",
  "organizationId": null,
  "teamId": null,
  "orgMemberId": null
}