Autentificare

Autentificare, reînnoirea tokenului, resetarea parolei, finalizarea SSO – și acces API prin chei API.

Acest grup cuprinde autentificarea utilizatorilor: autentificare cu adresă de e-mail sau nume de utilizator și parolă, reînnoirea sesiunii printr-un token de reîmprospătare, resetarea unei parole uitate și finalizarea unei autentificări unice (SAML/OIDC). Endpointurile returnează un token de acces (JWT), trimis în antetul `Authorization: Bearer <token>`, și un token de reîmprospătare care este înlocuit cu unul nou la fiecare utilizare.

Pentru accesul automatizat al propriilor programe la datele dumneavoastră, folosiți o cheie API pentru API-ul REST la `https://zentor-app.de/api/v1`, în locul autentificării de utilizator. Zentor activează accesul API la cerere; apoi administratorii creează în panoul de control, la „Chei API”, chei cu permisiuni definite (scopuri). Cheia se transmite în antetul `Authorization: Bearer <cheie API>` sau `X-API-Key`. Scopurile, codurile de eroare și recomandările privind păstrarea în siguranță se găsesc în prezentarea generală a referinței API.

Endpointurile de autentificare sunt protejate împotriva încercărilor repetate eșuate: după mai multe introduceri incorecte, serverul întârzie încercările următoare și le blochează temporar cu 429 `RATE_LIMIT_EXCEEDED`.

POST/api/auth/loginPOST/api/auth/refreshPOST/api/auth/forgot-passwordPOST/api/auth/reset-passwordPOST/api/auth/sso/exchange
← Referință API