App-API

Eigenen Key prüfen

Beantwortet, was der vorgelegte Key ist: Art, Scopes, Ablauf und Organisation. Der Ping der App-API.

GEThttps://api.futureway.ai/v1/me

Authentifizierung

Header: Authorization: Bearer $FUTUREWAY_API_KEY
Scope: inferenceInferenz-API: Chat-Completions, Embeddings, Modellliste.
Key-Arten: persönlich · Service
Format: FutureWay-Envelope

Details zu Keys und Scopes unter Authentifizierung.

Beispiel-Anfrage

curl https://api.futureway.ai/v1/me \
  -H "Authorization: Bearer $FUTUREWAY_API_KEY"

Antwort

200

{
  "key": {
    "id": "db72417d-eaa4-4bef-95df-127c54d98753",
    "kind": "service",
    "scopes": [
      "inference",
      "knowledge:read"
    ],
    "expires_at": "2026-12-13T07:47:06.057Z"
  },
  "organization": {
    "id": "37a2e31e-da2e-4b45-ad2c-907b42ec7668",
    "plan": "advanced"
  }
}

Fehler

Status	Code	Beschreibung
401	unauthorized	Kein, ungültiger oder widerrufener API-Key.
401	key_expired	Der Key ist abgelaufen — neuen Key anlegen.
403	scope_missing	Der Key trägt nicht den Scope, den dieser Endpunkt verlangt.
403	academy_only	Dieses Konto hat nur Zugang zur Akademie, nicht zur Plattform.
403	browser_request_rejected	Die Anfrage sieht wie ein Browser aus (Origin, Fetch-Metadaten oder Session-Cookie).
429	rate_limit_error	Zu viele Anfragen im Zeitfenster; retry-after nennt die Wartezeit.

Formate und Umgang mit Fehlern unter Fehler.