Avtentikacija

Prijava, obnovitev žetona, ponastavitev gesla, zaključek SSO – in dostop API s ključem API.

Ta skupina zajema prijavo uporabnikov: prijavo z e-poštnim naslovom ali uporabniškim imenom in geslom, obnovitev seje prek žetona za obnovitev, ponastavitev pozabljenega gesla in zaključek enotne prijave (SAML/OIDC). Končne točke vrnejo dostopni žeton (JWT), ki se pošlje v glavi `Authorization: Bearer <token>`, ter žeton za obnovitev, ki se ob vsaki uporabi zamenja z novim.

Za strojni dostop lastnih programov do vaših podatkov namesto prijave uporabnika uporabite ključ API za REST API na `https://zentor-app.de/api/v1`. Zentor na zahtevo omogoči dostop API; nato administratorji na nadzorni plošči pod „API-ključi“ ustvarijo ključe z določenimi pravicami (scope). Ključ se prenese v glavi `Authorization: Bearer <API-ključ>` ali `X-API-Key`. Scope, kode napak in napotke za varno hrambo najdete v pregledu referenčne dokumentacije API.

Končne točke prijave so zaščitene pred ponavljajočimi se neuspelimi poskusi: po nekaj napačnih vnosih strežnik zakasni nadaljnje poskuse in jih začasno zablokira s 429 `RATE_LIMIT_EXCEEDED`.

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← Referenca API