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?