API-Key nachschlagen
Nur lesende Suche mit denselben Mandanten-, Typ-, Eigentümer- und Ablauffiltern wie die Übersicht. Klartext-Keys gehören weder in diesen Anfrageinhalt noch in eine URL.
POST https://tokenlane.de/api/keys/lookup
Authentifizierung
[ [ { "name": "Authorization", "description": "Management-Key der Organisation: Authorization: Bearer sk-tl-v1-…. Bestehende sk-eu--Keys bleiben gültig. Erforderliche Scopes stehen in x-scopes; Inferenz-Keys berechtigen nicht zu Verwaltungsoperationen.", "type": "http bearer", "location": "", "scopes": [] } ] ]
Werte mit YOUR_ sind Platzhalter. Vor dem Senden durch passende eigene Werte ersetzen.
curl
curl --request POST \
--url 'https://tokenlane.de/api/keys/lookup' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Origin: https://tokenlane.de' \
--header 'Content-Type: application/json' \
--data '{
"workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
"keyHash": "YOUR_KEYHASH"
}'
node
const response = await fetch("https://tokenlane.de/api/keys/lookup", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
"Origin": "https://tokenlane.de",
"Content-Type": "application/json",
},
body: `{
"workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
"keyHash": "YOUR_KEYHASH"
}`,
});
console.log(await response.text());
python
import os
import urllib.request
body = (r'''{
"workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
"keyHash": "YOUR_KEYHASH"
}''').encode("utf-8")
request = urllib.request.Request(
"https://tokenlane.de/api/keys/lookup",
method="POST",
headers={
"Authorization": "Bearer " + os.environ["TOKENLANE_API_KEY"],
"Origin": "https://tokenlane.de",
"Content-Type": "application/json",
},
data=body,
)
with urllib.request.urlopen(request) as response:
print(response.read().decode("utf-8"))
vercel
// This operation uses HTTP directly.
const response = await fetch("https://tokenlane.de/api/keys/lookup", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
"Origin": "https://tokenlane.de",
"Content-Type": "application/json",
},
body: `{
"workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
"keyHash": "YOUR_KEYHASH"
}`,
});
console.log(await response.text());
Anfrageinhalt: application/json
{
"workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
"keyHash": "YOUR_KEYHASH"
}
s17: object
{"additionalProperties":"false"}
- q (optional): s0
s0: string
In Name und Anzeigepräfix suchen. Vollständige Keys nie senden. Stattdessen die SHA-256-Suche verwenden.
{"maxLength":"100"}
- owner (optional): s77
s77: anyOf
{}
anyOf: s51
s51: string
"me", "workspace"
{}
anyOf: s52
s52: string
Nach einem Organisationsmitglied filtern
{}
"mem_01k7tm3w8vfz6b2r4m9q5xyz7c"
- expiration (optional): s2
s2: string
Ablauffilter nach der Datenbankuhr: never hat kein expires_at, expired hat es erreicht (der Zeitpunkt selbst zählt wie im Gateway), scheduled liegt in der Zukunft
"never", "expired", "scheduled"
{}
- isManagement (optional): s3
s3: string
Key-Typ einschränken. Ohne Angabe bleibt die kombinierte bisherige Liste erhalten.
"true", "false"
{}
- workspaceId (optional): s4
s4: string
Nur Keys dieses Workspaces
{}
"wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
- status (optional): s5
s5: string
active sind aktivierte, nicht abgelaufene Keys, die das Gateway annimmt; disabled sind gesperrte Keys unabhängig vom Ablauf. Ohne Status bleiben aktivierte abgelaufene Keys in der Liste; mit expiration=expired lassen sie sich finden.
"active", "disabled"
{}
- sort (optional): s6
s6: string
"name", "createdAt"
{"default":"\"createdAt\""}
- order (optional): s7
s7: string
"asc", "desc"
{"default":"\"desc\""}
- page (optional): s8
s8: integer
{"minimum":"1","maximum":"1000000","default":"1"}
- pageSize (optional): s9
s9: integer
{"default":"20"}
- keyHash (Pflichtfeld): s78
s78: string
Lokal berechneter SHA-256-Hash. Den Klartext-Key nie senden.
{"pattern":"\"^[a-f0-9]{64}$\""}
Antwort 200: application/json
Anfrage erfolgreich
{
"items": [
{
"id": "key_01k7tm3w8vfz6b2r4m9q5xyz7c",
"name": "Production backend",
"keyPrefix": "sk-tl-v1-4fKq",
"workspace": {
"id": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
"name": "Default"
},
"isManagement": false,
"owner": {
"kind": "workspace"
},
"usage": {
"currency": "EUR",
"lastUsedAt": "YOUR_LASTUSEDAT",
"totalPicoEur": "YOUR_TOTALPICOEUR",
"periodPicoEur": "YOUR_PERIODPICOEUR",
"periodStartsAt": "YOUR_PERIODSTARTSAT",
"asOf": "YOUR_ASOF"
},
"disabled": false,
"policy": {
"allowed_models": [
"deepseek/deepseek-v4.1-flash",
"mistralai/*"
],
"denied_models": [
"openai/*"
],
"allowed_countries": [
"DE",
"FR"
],
"expires_at": "2026-12-31T23:59:59Z",
"limit": "25"
},
"createdAt": "YOUR_CREATEDAT",
"updatedAt": "YOUR_UPDATEDAT"
}
],
"total": 0,
"page": 0,
"pageSize": 0
}
s10: object
{}
- items (Pflichtfeld): s53
s53: array
{}
s15: object
{}
- id (Pflichtfeld): s66
s66: string
Key-Identität, nie der Key selbst
{}
"key_01k7tm3w8vfz6b2r4m9q5xyz7c"
- name (Pflichtfeld): s67
s67: string
{}
"Production backend"
- keyPrefix (Pflichtfeld): s68
s68: string
Anfang des Keys zur Wiedererkennung
{}
"sk-tl-v1-4fKq"
- workspace (Pflichtfeld): s69
s69: object
Workspace, zu dem der Key gehört
{}
- id (Pflichtfeld): s100
s100: string
{}
"wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
- name (Pflichtfeld): s103
s103: string
{}
"Default"
- isManagement (Pflichtfeld): s70
s70: boolean
Verwaltet Keys der Organisation und kann keine Modelle aufrufen.
{}
- owner (Pflichtfeld): s71
s71: oneOf
Beim Erstellen gewählte Zuordnung innerhalb der Organisation
{}
oneOf: s155
s155: object
{}
- kind (Pflichtfeld): s170
s170: string
"workspace"
{}
oneOf: s156
s156: object
{}
- kind (Pflichtfeld): s172
s172: string
"member"
{}
- memberId (Pflichtfeld): s35
s35: string
{}
- userId (Pflichtfeld): s35
- name (Pflichtfeld): s35
- email (Pflichtfeld): s35
- usage (Pflichtfeld): s43
s43: object
{}
- currency (Pflichtfeld): s81
s81: string
"EUR"
{}
- lastUsedAt (Pflichtfeld): s138
s138: string | null
Erstellungszeitpunkt der neuesten Generierung. Nie der Zeitpunkt einer Verwaltungsänderung.
date-time
{}
- totalPicoEur (Pflichtfeld): s139
s139: string | null
Alle aufgezeichneten Key-Kosten als ganze Pico-EUR. Null, wenn nicht verfügbar.
{"pattern":"\"^\\\\d+$\""}
- periodPicoEur (Pflichtfeld): s140
s140: string | null
Aufgezeichnete Kosten im aktuellen UTC-Zeitfenster der Regeln. Ohne Zurücksetzen über die gesamte Laufzeit.
{"pattern":"\"^\\\\d+$\""}
- periodStartsAt (Pflichtfeld): s86
s86: string | null
date-time
{}
- asOf (Pflichtfeld): s141
s141: string | null
Zeitpunkt der Abrechnungsprojektion. Null bei Antworten auf Änderungen oder wenn nicht anwendbar.
date-time
{}
- disabled (Pflichtfeld): s72
s72: boolean
Gesperrte Keys werden vom Gateway abgelehnt.
{}
- policy (Pflichtfeld): s40
s40: object
Regeln eines Keys in der vom Gateway gelesenen Form (gw_core::KeyPolicy). Unbekannte Felder werden abgelehnt. Für eine Anfrage gilt die Schnittmenge aus Organisations-, Workspace- und Key-Policy: Jede Ebene darf nur weiter einschränken.
{"additionalProperties":"false"}
- bridges (optional): s106
s106: object
Automatische Umwandlungen je Brücke (file-parser: PDF zu Text). Innere Ebenen können nur einschränken: ein strengerer Modus oder eine niedrigere Kostengrenze.
{"additionalProperties":"false"}
- file-parser (optional): s41
s41: object
Einschränkungen für eine Brücke auf einer Ebene.
{"additionalProperties":"false"}
- mode (optional): s128
s128: string
auto wandelt nur um, wenn der Request sonst scheitern würde, opt_in nur, wenn der Request das Plugin aktiviert, off nie. Weggelassen: auto.
"off", "opt_in", "auto"
{}
- max_auto_cost (optional): s129
s129: string | null
Höchste automatische Reservierung in EUR als Dezimalstring; null oder weggelassen übernimmt die konfigurierte Grenze. Ausdrücklich angefragte Plugins begrenzt sie nicht.
{}
"0.05"
- locked (optional): s130
s130: boolean
Requests können eine wirksame automatische Brücke nicht abschalten. Innere Ebenen können die Brücke wie immer weiter einschränken, aber nie lockern.
{}
- byok (optional): s107
s107: boolean | null
Finanzierung: true verlangt BYOK; false verbietet BYOK; null übernimmt die übergeordnete Regel.
{}
- allowed_models (optional): s108
s108: array
Modell-IDs oder Muster, die der Key verwenden darf. * steht für beliebige Werte. Ohne Angabe ist jedes Modell erlaubt.
{"minItems":"1","maxItems":"200"}
[
"deepseek/deepseek-v4.1-flash",
"mistralai/*"
]
s163: string
{"minLength":"1","maxLength":"256"}
"mistralai/*"
- denied_models (optional): s109
s109: array
Modell-IDs oder Muster, die trotz Übereinstimmung mit allowed_models abgelehnt werden. Eine Ablehnung auf irgendeiner Ebene hat immer Vorrang.
{"maxItems":"200"}
[
"openai/*"
]
- allowed_providers (optional): s110
s110: array
Provider, die Anfragen bedienen dürfen, benannt wie provider.only (Provider-ID oder provider/variant für eine Tarifvariante). Nicht angegeben: alle Provider.
{"minItems":"1","maxItems":"200"}
s164: string
{"minLength":"1","maxLength":"128"}
"mistral"
- denied_providers (optional): s111
s111: array
Provider, die keine Anfragen bedienen dürfen, benannt wie provider.ignore.
{"maxItems":"200"}
- allowed_countries (optional): s112
s112: array
Länder, in denen verarbeitet werden darf (ISO 3166-1 Alpha-2, Großbuchstaben). Eine Route kommt nur infrage, wenn sie ihre Verarbeitungsländer nennt und alle in der Liste stehen.
{"minItems":"1","maxItems":"249"}
[
"DE",
"FR"
]
s165: string
{"pattern":"\"^[A-Z]{2}$\""}
"DE"
- min_compliance (optional): s113
s113: string
Schwächste zulässige Einstufung der Rechtsordnung einer Route, in aufsteigender Reihenfolge: global (uneingeschränkt), eu_data_residency, eu_operated oder sovereign_eu.
"global", "eu_data_residency", "eu_operated", "sovereign_eu"
{}
- require_zdr (optional): s114
s114: boolean
Nur Routen ohne Aufbewahrung von Prompt- und Antwortinhalten.
{}
- deny_training (optional): s115
s115: boolean
Routen ausschließen, deren Provider Kundendaten möglicherweise zum Training nutzt (auch bei unbekanntem Status).
{}
- max_price (optional): s42
s42: object
Höchste akzeptierte Routenpreise in EUR als Dezimalstrings; eine Anfrage darf sie nicht erhöhen.
{"additionalProperties":"false"}
- prompt (optional): s131
s131: string
EUR pro Million Eingabetokens.
{}
"25"
- completion (optional): s132
s132: string
EUR pro Million Ausgabetokens.
{}
"25"
- request (optional): s133
s133: string
EUR pro Upstream-Anfrage.
{}
"25"
- image (optional): s134
s134: string
EUR pro Eingabebild.
{}
"25"
- audio (optional): s135
s135: string
EUR pro von der Route festgelegter Einheit der Audioeingabe.
{}
"25"
- page (optional): s136
s136: string
EUR je OCR-Seite.
{}
"25"
- character (optional): s137
s137: string
EUR je PII-Eingabezeichen.
{}
"25"
- forbid_capture (optional): s116
s116: boolean
Prompts und Antworten dürfen nicht gespeichert werden, unabhängig von capture am Key.
{}
- default_sort (optional): s117
s117: string
Standard für provider.sort, wenn die Anfrage keinen Wert nennt.
"price", "throughput", "latency"
{}
- default_allow_fallbacks (optional): s118
s118: boolean
Standard für provider.allow_fallbacks, wenn die Anfrage keinen Wert nennt.
{}
- locked (optional): s119
s119: array
Routing-Standards dieser Policy, die Anfragen und innere Ebenen nicht überschreiben dürfen. Für jede hier aufgeführte Einstellung muss dieselbe Policy einen Standardwert enthalten.
{}
s166: string
"sort", "allow_fallbacks"
{}
- rate_limits (optional): s120
s120: object
{"additionalProperties":"false"}
- rpm (optional): s167
s167: integer | null
{"minimum":"1","maximum":"4294967295"}
- tpm (optional): s167
- max_parallel_requests (optional): s167
- pii_redact (optional): s121
s121: array
Vom Betreiber eingerichtete, erzwungene Unkenntlichmachung. Lesen und Bearbeiten in der Verwaltung bewahren vorhandene Regeln; Änderungen dieser Regeln erfordern eine Betreiberprüfung der Detektor- und Providerkonfiguration.
{"maxItems":"16"}
s168: object
{"additionalProperties":"false"}
- when (optional): s184
s184: object
{"additionalProperties":"false"}
- below_compliance (optional): s191
s191: string | null
Schwächste zulässige Einstufung der Rechtsordnung einer Route, in aufsteigender Reihenfolge: global (uneingeschränkt), eu_data_residency, eu_operated oder sovereign_eu.
"global", "eu_data_residency", "eu_operated", "sovereign_eu", null
{}
- providers_except (optional): s192
s192: array | null
{"maxItems":"128"}
- models (optional): s193
s193: array | null
{"minItems":"1","maxItems":"128"}
- entities (optional): s185
s185: array
{"minItems":"1"}
s194: string
"person", "address", "email", "phone", "iban", "identifier", "date_of_birth", "organization"
{}
- threshold (optional): s186
s186: number
{"minimum":"0","maximum":"1"}
- restore (optional): s89
s89: boolean
{}
- expires_at (optional): s122
s122: string
Ab diesem Zeitpunkt wird der Key abgelehnt (RFC 3339).
date-time
{}
"2026-12-31T23:59:59Z"
- allow_attribution_export (optional): s123
s123: boolean | null
Der Export von Zuordnungsdaten des Aufrufers erfordert die globale Freigabe durch den Betreiber und die ausdrückliche Zustimmung des Keys mit true. false in Organisation, Workspace oder Key verhindert den Export; ein fehlender Wert oder null erbt die Vorgabe, ohne die Zustimmung des Keys zu erteilen.
{}
- capture (optional): s124
s124: boolean
Ob Prompts und Antworten dieses Keys für den späteren Abruf gespeichert werden.
{}
- limit (optional): s125
s125: string
EUR-Ausgabenlimit als Dezimalzeichenkette.
{}
"25"
- limit_reset (optional): s126
s126: string
UTC-Zeitfenster, nach dem die auf limit angerechneten Ausgaben bei 0 beginnen. Wochen beginnen am Montag.
"daily", "weekly", "monthly"
{}
- server_tools (optional): s127
s127: array
Vom Key verwendbare Server-Tools. Sie kosten zusätzlich und senden Teile der Anfrage an Dritte.
{}
s169: string
"web_search"
{}
- createdAt (Pflichtfeld): s73
s73: string
Erstellungszeitpunkt
date-time
{}
- updatedAt (Pflichtfeld): s74
s74: string
Zeitpunkt der letzten Aktualisierung
date-time
{}
- total (Pflichtfeld): s54
s54: integer
Anzahl der zu den Filtern passenden Keys
{}
- page (Pflichtfeld): s55
s55: integer
{}
- pageSize (Pflichtfeld): s55
Antwort 400: application/json
Ungültige Anfrage: Validierungsfehler oder ungültige Eingabe.
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
s11: object
{}
- requestId (optional): s56
s56: string
Serverseitige Zuordnungs-ID für einen internen Fehler. Auch in X-Request-Id enthalten.
uuid
{}
- status (Pflichtfeld): s57
s57: number
HTTP-Statuscode
{}
400
- code (Pflichtfeld): s58
s58: string
Fehlercode
{}
"VALIDATION_ERROR"
- message (Pflichtfeld): s59
s59: string
Fehlermeldung
{}
"Request validation failed"
- remedy_hint (optional): s60
s60: string
Sichere, ausführbare Abhilfe aus dem Fehlerkatalog.
{}
- details (optional): s61
s61: array
Detaillierte Validierungsfehler
{}
s154: object
{}
- path (Pflichtfeld): s179
s179: string
Feldpfad
{}
"title"
- message (Pflichtfeld): s180
s180: string
Fehlermeldung zum Feld
{}
"Required"
Antwort 401: application/json
Authentifizierung erforderlich: Zugangsdaten fehlen oder sind ungültig.
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 403: application/json
Berechtigungsumfang reicht nicht aus: authentifiziert, aber nicht berechtigt.
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 404: application/json
Ressource nicht gefunden
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 409: application/json
Aktuell veröffentlichte Bedingungen vor Fortsetzen dieser Sitzung lesen und akzeptieren
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 500: application/json
Interner Serverfehler
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 503: application/json
Konfigurierter Upstream hat das Zeitlimit überschritten, ist fehlgeschlagen oder hat eine ungültige Antwort geliefert.
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}