# Zoznam endpointov

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

Prehľad SAPI-SK a Enterprise API endpointov s odkazom na interaktívnu dokumentáciu.

Nižšie je prehľad. Úplnú referenciu vrátane schém, príkladov a tlačidla *Try it*
nájdete v interaktívnej dokumentácii.

<div class="cards">
  <a class="card card-link" href="/docs/#sapi">
    <span class="chip">štandard</span>
    <h3>SAPI-SK <span class="arrow" aria-hidden="true">→</span></h3>
    <p>Osem endpointov štandardizovaného rozhrania, interaktívne.</p>
    <span class="card-meta"><code>/docs/#sapi</code></span>
  </a>

  <a class="card card-link" href="/docs/#enterprise">
    <span class="chip chip-neutral">platforma</span>
    <h3>Enterprise API <span class="arrow" aria-hidden="true">→</span></h3>
    <p>Faktúry, webhooky, notifikácie, kredit a správa organizácie.</p>
    <span class="card-meta"><code>/docs/#enterprise</code></span>
  </a>
</div>

**Strojovo čitateľná špecifikácia.** Ak si generujete klienta, stiahnite si
OpenAPI priamo: [SAPI-SK](/openapi/sapi.json), [Enterprise API](/openapi/enterprise.json),
prípadne [obe naraz](/openapi.json). Pole `servers` sa dopĺňa podľa prostredia,
z ktorého spec stiahnete — vygenerovaný klient teda mieri tam, kam má.

### SAPI-SK <span class="chip">štandard</span>

| Metóda | Endpoint | Popis |
|---|---|---|
| <span class="method m-post">POST</span> | `/sapi/auth/token` | Vydá prístupový token |
| <span class="method m-post">POST</span> | `/sapi/auth/renew` | Obnoví token cez `refresh_token` |
| <span class="method m-post">POST</span> | `/sapi/auth/revoke` | Zneplatní token |
| <span class="method m-get">GET</span> | `/sapi/auth/token/status` | Zistí platnosť a či je čas na obnovu |
| <span class="method m-post">POST</span> | `/sapi/document/send` | Odošle dokument do siete Peppol |
| <span class="method m-get">GET</span> | `/sapi/document/receive` | Zoznam prijatých dokumentov |
| <span class="method m-get">GET</span> | `/sapi/document/receive/{id}` | Vráti prijatý dokument ako JSON (XML v poli payload) |
| <span class="method m-post">POST</span> | `/sapi/document/receive/{id}/acknowledge` | Potvrdí prevzatie dokumentu |
| <span class="method m-get">GET</span> | `/sapi/health` | Stav služby bez autentifikácie — rovnaké telo ako `/health` (200 / 503) |

### Enterprise API

| Metóda | Endpoint | Popis |
|---|---|---|
| <span class="method m-post">POST</span> | `/api/v1/invoices` | Vytvorí a odošle faktúru |
| <span class="method m-get">GET</span> | `/api/v1/invoices` | Zoznam faktúr, stránkovaný kurzorom |
| <span class="method m-get">GET</span> | `/api/v1/invoices/{id}` | Detail faktúry vrátane stavu |
| <span class="method m-get">GET</span> | `/api/v1/invoices/{id}/xml` | Pôvodné UBL XML |
| <span class="method m-get">GET</span> | `/api/v1/invoices/{id}/pdf` | PDF vizualizácia faktúry |
| <span class="method m-get">GET</span> | `/api/v1/invoices/search` | Fulltextové vyhľadávanie faktúr, stránkované kurzorom; s `scope=archive` namiesto aktuálnych v archivovaných faktúrach |
| <span class="method m-del">DELETE</span> | `/api/v1/invoices/{id}` | Zruší faktúru, kým je `PENDING` alebo `VALIDATING` |
| <span class="method m-post">POST</span> | `/api/v1/documents/validate` | Predbežná validácia dokumentu — bez odoslania, bez kreditu |
| <span class="method m-get">GET</span> | `/api/v1/participants/{peppolId}/reachability` | Overí, či je príjemca v sieti a podporuje daný typ dokumentu |
| <span class="method m-post">POST</span> | `/api/v1/webhooks` | Zaregistruje webhook |
| <span class="method m-post">POST</span> | `/api/v1/webhooks/{id}/test` | Pošle testovaciu udalosť |
| <span class="method m-get">GET</span> | `/api/v1/billing/balance` | Zostatok kreditu |
| <span class="method m-post">POST</span> | `/api/v1/sapi-clients` | Vytvorí SAPI klienta |

`documents/validate` a `participants/{peppolId}/reachability` slúžia na kontrolu pred
odoslaním: overia dokument aj dosiahnuteľnosť príjemcu, nevytvárajú faktúru a
nespotrebúvajú kredit. Tvar odpovede, význam poľa `reason` a limity rozoberá článok
[Predbežná validácia](/developers/predbezna-validacia/).