O chybách je používateľ informovaný pomocou stavového kódu HTTP.
HTTP kód | Význam |
200 OK | Operácia bola vykonaná úspešne. |
201 Created | Záznam bol úspešne vytvorený. V hlavičke |
304 Not Modified | Záznam nebol modifikovaný (v kombinácii s hlavičkou |
400 Bad Request | Nesprávna požiadavka. Zvyčajne nastáva pri operácii PUT, ktorá zlyhala (napr. odkazujete na objekt, ktorý neexistuje). |
401 Unauthorized | Používateľ sa musí pre vykonanie danej operácie prihlásiť. |
402 Payment Required | Cieľový systém nemá aktivované REST API pre zápis. Pri čítacích operáciách sa vracia 404. |
403 Forbidden | Používateľ nemá na túto operáciu oprávnenie. Táto chyba sa zobrazí aj v prípade, že danú operáciu neumožňuje licencia. |
404 Not Found | Záznam nenájdený. Môže ísť o evidenciu alebo konkrétny záznam (napr. preto, že bol vymazaný). |
405 Method Not Allowed | Použitá nepovolená metóda. Napríklad použitie metódy POST, kde je povolené dáta iba čítať metódou GET. |
406 Not Acceptable | Cieľový formát nie je nad konkrétnym zdrojom podporovaný (napr. export adresára ako ISDOC). |
500 Internal Server Error | Pri spracovaní požiadavky nastala vnútorná chyba servera. Za normálnych okolností by k tomu nemalo dôjsť a vždy ide o chybu v kóde ABRA Flexi. Informujte nás. |
Súčasťou odpovede, pokiaľ nejde o chybu 500, je zvyčajne aj popis v strojovo čitateľnej podobe (XML, JSON). Formát je zhodný s validačnými správami.
Ukážka chybovej odpovede:
<?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>