unauthenticated

Was er bedeutet

Es wurde ein Zugangsnachweis vorgelegt, der nicht überprüft werden konnte: Der Schlüssel ist unbekannt, widerrufen, fehlerhaft oder für Ironfang Finance nicht gültig. Anonymer Zugriff, wo ein Vorgang ihn erlaubt, sendet überhaupt keinen Zugangsnachweis; ein ungültiger Schlüssel fällt daher nie auf anonymen Zugriff zurück.

Was zu tun ist

Senden Sie einen gültigen API-Schlüssel der Plattform als Bearer-Token, oder für die anonymen Vorgänge gar keinen Authorization-Header.

Was die Antwort enthält

type

https://ironfang.uk/problems/unauthenticated, die englische Fassung dieser Seite.

status

Für diesen Code immer 401.

code

unauthenticated. Stabil: Verzweigen Sie anhand dieses Werts, nicht anhand des Wortlauts von title oder detail, die die API auf Englisch liefert.

detail

Was diesmal passiert ist, auf Englisch; kann einer Person angezeigt werden. Enthält nie Inhalte der Rechnung.

request_id

Derselbe Wert wie im Header X-Ironfang-Request-ID. Geben Sie ihn beim Support an.

retry_after_seconds

Bei diesem Code nie vorhanden.

outcome

Fehlt. Dieser Code ist keine Aussage über ein Dokument.

Problemantworten folgen RFC 9457 und werden als application/problem+json ausgeliefert. Ein Validierungsbefund ist nie eine Problemantwort: Eine ungültige Rechnung ist eine erfolgreiche Antwort, die ihre Befunde auflistet. Siehe alle Problemtypen, den Finance-Leitfaden und den OpenAPI-Vertrag (auf Englisch).