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ë fundi

Shembull 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

Artikuj të lidhur

← Vërtetimi