POST/api/auth/refresh
Itshintshanisa i-refresh-token esebenzayo ngombandela omutsha wethokheni yokufinyelela lerefresh token.
Thumelani `refreshToken` elamukelweyo khathesi emzimbeni we-JSON. Impendulo iqukethe i`token` entsha le`refreshToken` entsha. Ithokheni ye-refresh ngayinye isetshenziswa kanye kuphela njalo ngokujayelekileyo isebenza izinsuku eziyisikhombisa; ngemva kokubizwa ngakunye, gcina ithokheni entsha njalo ulahlele endala. I-refresh-token eswelekileyo, engasebenziyo, ephelelwe isikhathi kumbe eyasele isetshenzisiwe iholela ku-400 `VALIDATION_ERROR`. Umsebenzisi kumele abuye angene nge`POST /api/auth/login`. Ngoba i-refresh-token iqedwa nxa isisetshenzisiwe, isisebenzisi akumele sizame ukuvuselela ngasikhathi sinye.
Isifinyezo
Ukubiza: POST /api/auth/refresh. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kakusiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kutsha. Amapharamitha adingekayo: refreshToken (body). Izimo zamaphutha ezibhaliweyo: 400 VALIDATION_ERROR. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.
Ukuqinisekisa ubuwena lokuvikeleka
Kakudingeki ukuqinisekisa ubuwena
I-idempotent: Hatshi
Amapharamitha
refreshToken(body, string, kuyadingeka)— Irefresh-token ekhishiweyo khathesiIsibonelo sesicelo (request)
{"refreshToken":"<Refresh-Token evela ku-/login>"}Isibonelo sempendulo (response)
{"ok":true,"token":"<JWT entsha>","refreshToken":"<Refresh-Token entsha>"}Amakhodi amaphutha
400 VALIDATION_ERROR — Irefresh-token iswelekile, kayisebenzi, iphelelwe isikhathi kumbe eyasele isetshenzisiwe.Ukuziphatha okuhlolwe
Irefresh-token esebenzayo inikeza ibhango elitsha lamathokheni; ithokheni engasebenziyo inikeza i-400 `VALIDATION_ERROR`.
Ukuqinisekiswa
POST /api/auth/loginIngenisa umsebenzisi ngekheli le-imeyili kumbe ibizo lokusebenzisa lephasiwedi njalo ikhuphe ithokheni yokufinyelela (JWT) kanye lerefresh token.POST /api/auth/forgot-passwordIqala ukusetha kutsha iphasiwedi: nxa i-akhawunti elekheli le-imeyili elinikeziweyo ikhona, ithola i-imeyili elesixhumanisi sokusetha kutsha.POST /api/auth/reset-passwordIsetha iphasiwedi entsha ngethokheni ye-reset evela ku-imeyili yokusetha kutsha.POST /api/auth/sso/exchangeIsinyathelo sokucina sokungena nge-SSO (SAML/OIDC): itshintshanisa ikhodi yakanye evela ekuqondisweni kutsha ngethokheni yokufinyelela lerefresh token.