POST/api/auth/refresh
Shkëmbon një refresh-token të vlefshëm me një çift të ri token aksesi dhe refresh-token.
Dërgoni `refreshToken`-in e marrë së fundi në trupin JSON. Përgjigja përmban një `token` të ri dhe një `refreshToken` të ri. Çdo refresh-token mund të përdoret vetëm një herë dhe është i vlefshëm për shtatë ditë si parazgjedhje; pas çdo thirrjeje ruani token-in e ri dhe hiqni të vjetrin. Një refresh-token që mungon, është i pavlefshëm, i skaduar ose tashmë i përdorur çon në 400 `VALIDATION_ERROR`. Përdoruesi duhet të hyjë përsëri përmes `POST /api/auth/login`. Pasi një refresh-token konsumohet me përdorimin, një klient duhet të shmangë rinovimet paralele.
Përmbledhje
Thirrja: POST /api/auth/refresh. Ky endpoint i përket grupit “Vërtetimi” të API-së së Zentor App. Është i aksesueshëm publikisht dhe nuk kërkon autentifikim. Thirrja nuk është idempotente: çdo thirrje e suksesshme e shkakton veprimin përsëri. Parametrat e detyrueshëm: refreshToken (body). Rastet e dokumentuara të gabimeve: 400 VALIDATION_ERROR. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.
Autentifikimi dhe siguria
Nuk kërkohet autentifikim
Idempotent: Jo
Parametrat
refreshToken(body, string, i detyrueshëm)— Refresh-token-i i lëshuar së fundiShembull request-i
{"refreshToken":"<refresh token nga /login>"}Shembull response-i
{"ok":true,"token":"<JWT i ri>","refreshToken":"<refresh token i ri>"}Kodet e gabimeve
400 VALIDATION_ERROR — Refresh-token-i mungon, është i pavlefshëm, i skaduar ose tashmë i përdorur.Sjellja e verifikuar
Një refresh-token i vlefshëm kthen një çift të ri tokenash; një token i pavlefshëm kthen 400 `VALIDATION_ERROR`.
Vërtetimi
POST /api/auth/loginIdentifikon një përdorues me adresën e e-mailit ose emrin e përdoruesit dhe fjalëkalimin, dhe lëshon një token aksesi (JWT) dhe një refresh-token.POST /api/auth/forgot-passwordNis rivendosjen e një fjalëkalimi: nëse ekziston një llogari me adresën e dhënë të e-mailit, ajo merr një e-mail me një lidhje për rivendosjen.POST /api/auth/reset-passwordVendos një fjalëkalim të ri me token-in e rivendosjes nga e-maili.POST /api/auth/sso/exchangeHapi i fundit i një identifikimi SSO (SAML/OIDC): shkëmbon kodin një-herësh nga ridrejtimi me një token aksesi dhe një refresh-token.