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) | 10–100 / s na klienta | 20–200 / s na organizáciu |