Autentifikácia

Prihlásenie, obnovenie tokenu, reset hesla, dokončenie SSO – a prístup k API pomocou API kľúčov.

Táto skupina zahŕňa prihlasovanie používateľov: prihlásenie e-mailovou adresou alebo používateľským menom a heslom, obnovenie relácie pomocou obnovovacieho tokenu, reset zabudnutého hesla a dokončenie prihlásenia cez jednotné prihlásenie (SAML/OIDC). Endpointy vracajú prístupový token (JWT), zasielaný v hlavičke `Authorization: Bearer <token>`, a obnovovací token, ktorý sa pri každom použití nahrádza novým.

Na strojový prístup vašich vlastných programov k vašim dátam používate namiesto prihlásenia používateľa API kľúč pre REST API na adrese `https://zentor-app.de/api/v1`. Zentor na požiadanie sprístupní API; administrátori potom v dashboarde v časti „API kľúče“ vytvárajú kľúče s definovanými oprávneniami (scopes). Kľúč sa prenáša v hlavičke `Authorization: Bearer <API kľúč>` alebo v `X-API-Key`. Scopes, chybové kódy a pokyny na bezpečné uloženie nájdete v prehľade API referencie.

Prihlasovacie endpointy sú chránené proti opakovaným neúspešným pokusom: po niekoľkých chybných zadaniach server ďalšie pokusy spomalí a dočasne ich blokuje kódom 429 `RATE_LIMIT_EXCEEDED`.

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