POST/api/auth/refresh
Tshintshela i-refresh-token esebenzayo ngesibini esitsha se-token yokufikelela kunye ne-refresh token.
Thumela i`refreshToken` enikelwe kutshanje kumzimba we-JSON. Impendulo iqulathe i`token` entsha kunye ne`refreshToken` entsha. I-refresh token nganye isebenziswa kube kanye kuphela kwaye ngokungagqibekanga isebenza iintsuku ezisixhenxe; emva kwenxuso nganye, gcina i-token entsha kwaye ulahlele endala. I-refresh-token engekhoyo, engasebenziyo, ephelelwe ixesha okanye yasele isetyenziswa ikhokelela ku-400 `VALIDATION_ERROR`. Umsebenzisi kufuneka angene kwakhona nge`POST /api/auth/login`. Ekubeni i-refresh-token iqhwalelwa xa isetyenziswa, umxhasi akafuneki azame uhlaziyo ngaxeshanye.
Ushwankathelo
Ukubiza: POST /api/auth/refresh. Le endpoint yeyeqela elithi “Uqinisekiso” le-API ye-Zentor App. Ifikeleleka esidlangalaleni kwaye ayifuni kuqinisekiswa kwesazisi (authentication). Ukubiza ayisiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kwakhona. Iipharamitha ezinyanzelekileyo: refreshToken (body). Iimeko zeempazamo ezibhaliweyo: 400 VALIDATION_ERROR. Impendulo engumzekelo engezantsi ibonisa ulwakhiwo lwempendulo ephumelelayo ngefomathi ye-JSON.
Ukuqinisekiswa nokhuseleko
Akukho kuqinisekiswa kufunekayo
Idempotent: Hayi
Iiparamitha
refreshToken(body, string, kuyafuneka)— I-refresh token enikezwe kutshanjeUmzekelo we-request
{"refreshToken":"<Refresh token evela ku-/login>"}Umzekelo we-response
{"ok":true,"token":"<JWT entsha>","refreshToken":"<Refresh token entsha>"}Iikhowudi zeempazamo
400 VALIDATION_ERROR — I-refresh token ingekho, ayisebenzi, iphelelwe ixesha okanye yasele isetyenziswa.Ukuziphatha okujongwe
I-refresh-token esebenzayo inika isibini esitsha se-token; i-token engasebenziyo inika i-400 `VALIDATION_ERROR`.
Uqinisekiso
POST /api/auth/loginIngenisa umsebenzisi ngedilesi ye-imeyile okanye igama lomsebenzisi kunye nephasiwedi kwaye ikhuphe i-token yokufikelela (JWT) kunye ne-refresh token.POST /api/auth/forgot-passwordIqalisa ukusetwa kwakhona kwephasiwedi: ukuba i-akhawunti enedilesi ye-imeyile enikeziweyo ikhona, ifumana i-imeyile enekhonkco lokusetwa kwakhona.POST /api/auth/reset-passwordIsetha iphasiwedi entsha nge-token ye-reset evela kwi-imeyile yokusetwa kwakhona.POST /api/auth/sso/exchangeInyathelo lokugqibela lokungena nge-SSO (SAML/OIDC): itshintshanisa ikhowudi yesihlandlo esinye evela kwisiqondiso kabusha nge-token yokufikelela kunye ne-refresh token.