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
- Prístupový token
- 15 minút
- Obnovovací token
- 7 dní
- Signál na obnovu
- 3 min pred koncom
- Zamknutie účtu
- 15 minút
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ý.