# Autentifikácia

URL: https://postman.slovakodata.com/developers/autentifikacia/
Aktualizované: 2026-07-24

OAuth 2.0 s grantom client_credentials, povinné hlavičky a životný cyklus tokenu.

OAuth 2.0 s grantom `client_credentials`. Bez prehliadača, bez presmerovaní.

### Povinné hlavičky

| Hlavička | Kde | Popis |
|---|---|---|
| `Authorization` | všade | `Bearer <access_token>` z `/sapi/auth/token`. |
| `X-Peppol-Participant-Id` | `/sapi/document/*` | Váš identifikátor vo formáte `{schéma}:{id}`, napr. `0245:2020317068` — pri schéme `0245` je identifikátorom desaťmiestne DIČ. Musí patriť tej istej organizácii ako token. |
| `Idempotency-Key` | `/sapi/document/send` | UUID, ktoré si vygenerujete vy. Platí 24 hodín. |

### Životný cyklus tokenu

<dl class="facts">
  <div class="fact">
    <dt>Prístupový token</dt>
    <dd>15<small> minút</small></dd>
  </div>
  <div class="fact">
    <dt>Obnovovací token</dt>
    <dd>7<small> dní</small></dd>
  </div>
  <div class="fact">
    <dt>Signál na obnovu</dt>
    <dd>3<small> min pred koncom</small></dd>
  </div>
  <div class="fact">
    <dt>Zamknutie účtu</dt>
    <dd>15<small> minút</small></dd>
  </div>
</dl>

Token si **cachujte** a obnovujte až tesne pred expiráciou. Endpoint
`/sapi/auth/token/status` vám povie, či je čas na obnovu — príznak
`should_refresh` sa zapne tri minúty pred koncom platnosti. Pri obnove sa
rotuje aj obnovovací token, takže si vždy uložte ten nový.

**Nežiadajte token pred každou požiadavkou.** Opakované neúspešné pokusy o
token účet dočasne zamknú — dostanete `423` s kódom `SAPI-AUTH-005`. Je to
ochrana proti hádaniu hesiel.