Zum Hauptinhalt springen
POST
Consumer-API-Schlüssel erstellen
Erstellt einen neuen persönlichen API-Schlüssel für den authentifizierten Verbraucher. Das vollständige Geheimnis wird einmal in der Antwort zurückgegeben und kann nicht erneut abgerufen werden – speichern Sie es sicher. Jeder Verbraucher kann bis zu 5 aktive Schlüssel besitzen. Schlüssel verfallen automatisch nach 90 Tagen.

Antworten

Autorisierungen

Authorization
string
header
erforderlich

JWT für benutzerinitiierte Operationen

Body

application/json
name
string
erforderlich

Eine menschenlesbare Bezeichnung für den Schlüssel

Antwort

API-Schlüssel erstellt. Das Geheimnis wird nur in dieser Antwort angezeigt.

key_id
string<uuid>
name
string

Menschenlesbare Bezeichnung für den Schlüssel

prefix
string

Erste 12 Zeichen des Schlüssels, zur Anzeige

status
enum<string>
Verfügbare Optionen:
active,
revoked
scopes
string[]

Diesem Schlüssel gewährte Berechtigungsumfänge

created_at
string<date-time>
expires_at
string<date-time>

Schlüssel verfallen 90 Tage nach Erstellung

last_used_at
string<date-time>

Zeitstempel der letzten Anfrage, die mit diesem Schlüssel gestellt wurde

secret
string

Vollständiger API-Schlüsselwert (einmal angezeigt)