# Dve integračné cesty

URL: https://postman.slovakodata.com/developers/ktorou-cestou/
Aktualizované: 2026-09-29

Vyberte podľa toho, či je pre vás dôležitejšia prenositeľnosť, alebo výbava.

### SAPI-SK v1.0 — štandard

Národne štandardizované rozhranie. Rovnaký kód funguje u ktoréhokoľvek
slovenského poskytovateľa, ktorý SAPI-SK implementuje. Žiadny vendor
lock-in.

- OAuth 2.0, telo požiadavky je JSON obálka (payload = UBL XML)
- Povinná idempotencia každého odoslania
- 8 endpointov, 19 chybových kódov

### Enterprise API — platforma

Naše rozšírené rozhranie. Všetko, čo vie SAPI, plus to, čo štandard
nerieši — udalosti, PDF vizualizácia, kredit, vyhľadávanie v archíve.

- Webhooky podpísané HMAC-SHA256
- štyri typy udalostí, e-mail aj webhook
- PDF vizualizácia a fulltext nad archívom

| Vlastnosť | SAPI-SK | Enterprise API |
|---|---|---|
| Prenositeľné k inému poskytovateľovi | áno | nie |
| Telo požiadavky | JSON obálka (payload = UBL XML) | JSON |
| Autentifikácia | OAuth 2.0 (Bearer) | API kľúč (`X-Api-Key`) |
| Odosielanie a príjem faktúr | áno | áno |
| Webhooky o udalostiach | nie | áno |
| PDF vizualizácia faktúry | nie | áno |
| Limit požiadaviek ([podľa balíka](/developers/limity/)) | 10–100 / s na klienta | 20–200 / s na organizáciu |

**Dajú sa kombinovať.** Bežné nasadenie posiela faktúry cez SAPI-SK (aby
zostalo prenositeľné) a zároveň si registruje webhooky cez Enterprise API
(aby nemuselo stav opakovane zisťovať dotazovaním).