Go-live checklist pre API integráciu
Tento návod je kontrolný zoznam krokov pred nasadením API integrácie do produkcie.
Krok 1: Otestujte celý tok
Overte v testovacom prostredí celý tok integrácie — vystavenie dokladu, odoslanie a spracovanie odpovede — skôr než prepnete na produkciu.
Krok 2: Ošetrite chyby a rate limit
Aplikácia musí korektne spracúvať chybové kódy a rešpektovať limit počtu requestov za minútu podľa vášho plánu (Pro 40, Ultra 80, Ultra+ 200 req/min).
Krok 3: Bezpečne uložte kľúče
API kľúče musia byť v server-side prostredí alebo secret store — nikdy v klientskom kóde ani v repozitári.
Krok 4: Zabezpečte idempotenciu
Pri opakovaní požiadaviek si ukladajte id vytvorených dokladov, aby ste predišli duplicitám.
Krok 5: Skontrolujte mapovanie organizácie
Pre každú organizáciu posielate správnu hlavičku X-Organization-Id, ktorú získate cez GET /v1/agent/organizations.
Krok 6: Otestujte webhooky
Ak odber udalostí využívate, overte, že váš endpoint odpovedá HTTP 2xx a že správne overuje HMAC podpis doručenia — pozri návod Webhooky.
Pozor: Prekročenie mesačnej kvóty API volaní bez explicitného súhlasu s overage sa odmietne s HTTP 429. Po udelení súhlasu sa nadlimitné volania účtujú podľa aktuálnej sadzby plánu za 1000 volaní.
Tip: Kompletnú dokumentáciu aj stav produkčnej aktivácie sledujte na developers.efaktura.sk — priamy odkaz nájdete aj na stránke Nastavenia → API kľúče.
Súvisiace návody
Pomohol vám tento návod?