Dve integračné cestyTwo integration paths
Vyberte podľa toho, či je pre vás dôležitejšia prenositeľnosť, alebo výbava.Choose based on whether portability or capability matters more to you.
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
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 | 50 / s | 100 / s |
SAPI-SK v1.0 — standard
The nationally standardised interface. The same code works with any Slovak
provider implementing SAPI-SK. No vendor lock-in.
- OAuth 2.0, request body is a JSON envelope (payload = UBL XML)
- Idempotency required on every send
- 8 endpoints, 19 error codes
Our extended interface. Everything SAPI does, plus what the standard
leaves out — events, PDF rendering, credit, archive search.
- Webhooks signed with HMAC-SHA256
- four event types, e-mail and webhook
- PDF rendering and full-text archive search
| Capability | SAPI-SK | Enterprise API |
|---|
| Portable to another provider | yes | no |
| Request body | JSON envelope (payload = UBL XML) | JSON |
| Authentication | OAuth 2.0 (Bearer) | API key (X-Api-Key) |
| Send and receive invoices | yes | yes |
| Event webhooks | no | yes |
| PDF rendering | no | yes |
| Rate limit | 50 / s | 100 / s |