Zum Hauptinhalt springen

unauthorized

HTTP 401 · code: "unauthorized" · type: https://docs.formfeed.dev/errors/unauthorized

Die Anfrage enthält keinen API-Schlüssel, oder der Schlüssel ist keiner, den Formfeed annimmt. detail sagt, welcher Fall vorliegt: gar kein Schlüssel, ein Schlüssel im falschen Format, oder API key rejected: gefolgt vom Grund (unknown key, key revoked, key expired oder organisation deleted). Eine Antwort ganz ohne Schlüssel trägt zusätzlich den Header WWW-Authenticate: Bearer realm="formfeed".

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "API key rejected: key revoked",
  "code": "unauthorized",
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen​

  • Kein Header Authorization: Bearer … oder X-API-Key, oder ein Tippfehler im Headernamen (detail: Provide your API key as Authorization: Bearer ff_live_…).
  • Etwas anderes als ein Schlüssel im Header, etwa mitkopierte Anführungszeichen oder ein Zeilenumbruch, ein abgeschnittener Schlüssel oder ein stehengebliebener Platzhalter (detail: The API key format is not recognised). Ein Schlüssel ist ff_live_ oder ff_test_, gefolgt von 20 bis 64 Buchstaben und Ziffern.
  • Der Schlüssel wurde widerrufen, oder sein Ablaufdatum ist vorbei. Ein widerrufener Schlüssel kann noch bis zu einer Minute funktionieren, weil Schlüssel-Abfragen 60 Sekunden zwischengespeichert werden.
  • Ein Schlüssel aus einer anderen Formfeed-Umgebung, etwa ein Staging-Schlüssel gegen die Produktion: Dort ist er ein unknown key.
  • Die Organisation des Schlüssels wurde gelöscht.

So beheben Sie es​

  • Prüfen Sie den Header: Authorization: Bearer ff_live_… (oder ff_test_…) oder X-API-Key: ff_live_….
  • Schlagen Sie den Schlüssel in der App unter API-Schlüssel nach: Dort sehen Sie, ob er aktiv ist und wann er zuletzt verwendet wurde.
  • Erstellen Sie einen neuen Schlüssel, wenn der alte widerrufen wurde oder abgelaufen ist. Siehe Authentifizierung.

Wiederholen?​

Nein. Dieselbe Anfrage liefert dieselbe Antwort; senden Sie zuerst einen gültigen Schlüssel.