O chybách je uživatel informován pomocí stavového kódu HTTP.
HTTP kód | Význam |
200 OK | Operace byla provedena úspěšně. |
201 Created | Záznam byl úspěšně vytvořen. V hlavičce |
304 Not Modified | Záznam nebyl modifikován (v kombinaci s hlavičkou |
400 Bad Request | Špatný požadavek. Obvykle nastává při operaci PUT, která selhala (např. odkazujete na objekt, který neexistuje). |
401 Unauthorized | Uživatel se musí pro provedení dané operace přihlásit. |
402 Payment Required | Cílový systém nemá aktivované REST API pro zápis. U čtecích operací se vrací 404. |
403 Forbidden | Uživatel na tuto operaci nemá oprávnění. Tato chyba se zobrazí i v případě, že danou operaci neumožňuje licence. |
404 Not Found | Záznam nenalezen. Může se jednat o evidenci nebo konkrétní záznam (např. proto, že byl smazán). |
405 Method Not Allowed | Použita nepovolená metoda. Například použití metody POST, kde je povoleno data pouze číst metodou GET. |
406 Not Acceptable | Cílový formát není nad konkrétním zdrojem podporovaný (např. export adresáře jako ISDOC). |
500 Internal Server Error | Při zpracování požadavku nastala vnitřní chyba serveru. Toto by za normálních okolností nemělo nastat a vždy se jedná o chybu v kódu ABRA Flexi. Informujte nás. |
Součástí odpovědi, pokud nejde o chybu 500, je obvykle i popis ve strojově čitelné podobě (XML, JSON). Formát je shodný s validačními zprávami.
Ukázka chybové odpovědi:
<?xml version="1.0"?>
<winstrom version="1.0">
<success>false</success>
<result>
<id>105</id>
<error>Je očekáváno číselné ID, ale 'null' není číslo</error>
</result>
</winstrom>