API · 400/500 · vývojári
API chyba musí viesť k oprave, nie k hádaniu.
Pri integráciách e-faktúr sa budú objavovať chyby 400, 409, 422 alebo 500. Dôležité je rozlíšiť, či ide o nevalidné dáta, duplicitu, dočasný výpadok alebo chybu poskytovateľa.
Prevádzkový cieľ: každý problém má mať stav, dôkaz, vlastníka a ďalší krok. Bez toho sa e-faktúra mení na hľadanie v mailoch, logoch a účtovnom systéme.
Ako čítať chyby
- 400 alebo 422 zvyčajne znamená problém vstupu alebo validácie
- 409 môže signalizovať duplicitu alebo konflikt stavu
- 500 alebo 503 je skôr serverový alebo dočasný problém
- každá odpoveď má mať request ID a zrozumiteľný popis
Čo má mať dobrá integrácia
- idempotency key pri odosielaní
- retry len pri bezpečných typoch chýb
- logovanie request ID a dokument ID
- odkaz na detail validačného pravidla
- separátne prostredie na testovanie