API quickstart
Tento návod vysvetľuje, ako začať pracovať s REST API eFaktúry — vytvorenie kľúča, autentifikáciu a prvé volanie.
Krok 1: Vytvorte API kľúč
Prejdite do Nastavenia → API kľúče a kliknite na Vytvoriť kľúč (pri prvom kľúči Vytvoriť prvý kľúč). Zadajte názov (napr. "Môj e-shop") a vyberte oprávnenia (scopes). API prístup je dostupný od plánu Pro vyššie — Free plán ho nemá.
Krok 2: Uložte si kľúč
Kľúč sa po vytvorení zobrazí iba raz — skopírujte si ho ihneď a uložte na bezpečné miesto (server-side prostredie alebo secret store, nikdy do klientského kódu ani repozitára).
Krok 3: Zistite UUID organizácie
Väčšina endpointov vyžaduje okrem kľúča aj hlavičku s organizáciou. UUID zistíte cez GET /v1/agent/organizations — tento endpoint (aj firemný lookup /v1/agent/company-lookup) hlavičku organizácie nevyžaduje, všetky ostatné endpointy áno.
Krok 4: Vykonajte prvé volanie
Každý request posiela dve povinné hlavičky:
X-API-Key: VÁŠ_API_KĽÚČ
X-Organization-Id: UUID_ORGANIZÁCIE
Základné endpointy: faktúry (GET/POST /v1/agent/invoices), kontakty (GET/POST /v1/agent/customers), výdavky (GET/POST/PATCH /v1/agent/expenses), dashboard súhrn (GET /v1/agent/dashboard/summary) a firemný lookup podľa IČO. Odpovede sú v JSON — zoznamy majú tvar { "data": [...], "meta": {...} }, chyby { "error": { "code", "message" } }.
Pozor: Bez
X-Organization-IdAPI request odmietne (okrem výnimiek vyššie).
Tip: Pre každú integráciu si vytvorte samostatný kľúč — ak jeden kompromitujete, ostatné zostanú bezpečné. Kompletnú dokumentáciu nájdete na developers.efaktura.sk, odkaz je aj priamo na stránke API kľúčov.
Súvisiace návody
Pomohol vám tento návod?