Přeskočit na hlavní obsah

Chyba 503 Service Unavailable při importu

Odpovídá proxy, ne jádro — požadavek zopakujte a chraňte se identifikátory

Autor: Petr Pech

Import přes API občas skončí odpovědí:

503 Service Unavailable

Nejde o chybu dat — požadavek se k jádru ABRA Flexi vůbec nedostal. Odpovídá proxy před aplikačním serverem, typicky když je server krátkodobě vytížený nebo se restartuje.


Co s tím

  • Požadavek zopakujte. Při opakování obvykle projde.

  • Zopakování si ošetřete v integraci — u dávkových importů se vyplatí automatické opakování s několikasekundovou prodlevou a omezeným počtem pokusů.

  • Ověřte si výsledek. Odpověď 503 znamená, že se import neprovedl. Přesto se vyplatí před opakováním ověřit, jestli záznam nevznikl — použijete-li v importu vlastní identifikátor (kód nebo externí ID), opakovaný požadavek záznam jen aktualizuje a duplicita nevznikne.

💡 Proti duplicitám při opakování je nejlepší obranou vlastní identifikátor v každém importovaném záznamu. Import je pak idempotentní — viz Identifikátory záznamů.

⚠️ Opakuje-li se 503 soustavně, nejde o běžný výpadek — obraťte se na podporu. Stejně tak u odpovědi 504, která znamená, že požadavek běžel příliš dlouho; tu popisuje článek REST API vrací timeout.


Související

Dostali jste odpověď na svou otázku?