Fehlermeldungen

Fehlermeldungen werden immer alle innerhalb der Rückantwort im JSON angegeben. Es gibt ein paar Ausnahmen, wo die Transportschicht ein Fehler meldet, mehr dazu unter Verbindung.

Fehlermeldung Block

Wenn die Api einen Fehler entdeckt hat, oder glaubt ein Fehler gefunden zu haben, dann wird das Feld isError im Block requestStatus auf true gesetzt.

Weiterhin befindet sich dann eine Human-Readable Fehlermeldung im Feld .requestStatus.errorMessage.

Das sieht in etwa so aus:

{
    "requestStatus": {
        "isError": true,
        "errorMessage": "Fehlermeldungstext, der relativ eindeutig sein sollte"
    }
}

Sobald .requestStatus.isError auf true gesetzt ist, ist die Antwort auf jeden Fall ungültig. Selbst dann, wenn schon wilde Antwort Fragmente in dem JSON sein sollten. Die Aktion wurde definitiv nicht ausgeführt, oder während der Aktion ist etwas daneben gegangen. In diesem grenzwertigen Fall hilft nur ein Blick in die Logfiles.

Ist .requestStatus.isError auf false, oder erscheint das .requestStatus.isError gar nicht erst in der Antwort, dann ist es automatisch false. Was bedeutet, das die Anfrage mit voller Zufriedenheit sauber und korrekt abgearbeitet wurde.

Datenfelder

Wenn ein Feld den Default Wert hat, wird er nicht mit übertragen.

Name Typ Default Beschreibung
.requestStatus Record - Der Datenblock der den Status des Request speichert
.requestStatus.isError Boolean false Wenn es ein Fehler gab, wird dieser Wert auf true gesetzt
.requestStatus.errorMessage String - Beinhaltet die Human-Readable Fehlermeldung, sofern es ein Fehler gab
.requestStatus.isDeprecated Boolean false Wenn die benutzte API Deprecated ist, wird das Feld auf True gesetzt
.requestStatus.deprecatedMessage String - Beinhaltet die Human-Readable Meldungen, was man ggf. machen muss

Fehlermeldungen

Das sind mögliche Fehlermeldungen, die man so in .requestStatus.errorMessage finden könnte/würde/sollte. Ich hoffe das ich alle hier dokumentiert hab und was man gegen tun kann. Wenn jemand eine vermisst, bitte melden.

No valid authKey found

Der Auth Block wurde nicht angegeben, oder der angegebene Key ist nicht existent, oder der angegebene Key ist nicht aktiv. Ohne ein aktivierten gültigen Key macht die Api nichts. Weitere Informationen findet man unter Authentifikation

Unknown action

Es wurde keine Aktion definiert, oder es wurde eine definiert die es nicht gibt. Eine Action wird zwingend benötigt, ohne die wüsste die Api auch nicht was zu tun wäre. Weitere Informationen findet man unter Action

Corvus Help - 28.February 2026 03:33:38 UTC - Commit 667ccc2e