Import cez API občas skončí odpoveďou:
503 Service Unavailable
Nejde o chybu dát — požiadavka sa k jadru ABRA Flexi vôbec nedostala. Odpovedá proxy pred aplikačným serverom, typicky keď je server krátkodobo vyťažený alebo sa reštartuje.
Čo s tým
Požiadavku zopakujte. Pri opakovaní obvykle prejde.
Zopakovanie si ošetrite v integrácii — pri dávkových importoch sa oplatí automatické opakovanie s niekoľkosekundovou prodlevou a obmedzeným počtom pokusov.
Overte si výsledok. Odpoveď
503znamená, že sa import nevykonal. Napriek tomu sa oplatí pred opakovaním overiť, či záznam nevznikol — ak v importe použijete vlastný identifikátor (kód alebo externé ID), opakovaná požiadavka záznam iba aktualizuje a duplicita nevznikne.
💡 Proti duplicitám pri opakovaní je najlepšou obranou vlastný identifikátor v každom importovanom zázname. Import je potom idempotentný — pozri Identifikátory záznamov.
⚠️ Ak sa 503 opakuje sústavne, nejde o bežný výpadok — obráťte sa na podporu. Rovnako tak pri odpovedi 504, ktorá znamená, že požiadavka bežala príliš dlho; tú popisuje článok REST API vracia timeout.