POST/api/auth/refresh
Shintshanisa i-refresh-token esebenzayo ngombandela omusha wethokheni yokufinyelela nethokheni ye-refresh.
Thumela `refreshToken` elamukelwe muva kumzimba we-JSON. Impendulo iqukethe i`token` entsha ne`refreshToken` entsha. Ithokheni ye-refresh ngayinye isetshenziswa kanye kuphela futhi ivamile ukusebenza izinsuku eziyisikhombisa; ngemva kokubizwa ngakunye, gcina ithokheni entsha futhi ulahlele endala. I-refresh-token eshodayo, engasebenzi, ephelelwe isikhathi noma eyasivele isetshenzisiwe iholela ku-400 `VALIDATION_ERROR`. Umsebenzisi kufanele abuye angene nge`POST /api/auth/login`. Ngoba i-refresh-token iqedwa uma isisetshenzisiwe, isisebenzi akufanele sizame ukuvuselela kafushane ngasikhathi sinye.
Ukubuka konke
Ukubiza: POST /api/auth/refresh. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza akuyona i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kabusha. Amapharamitha ayimpoqo: refreshToken (body). Izimo zamaphutha ezibhaliwe: 400 VALIDATION_ERROR. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.
Ukuqinisekisa ubunikazi nokuvikeleka
Akudingeki ukuqinisekisa ubunikazi
I-idempotent: Cha
Amapharamitha
refreshToken(body, string, kuyadingeka)— Ithokheni ye-refresh ekhishiwe muvaIsibonelo se-request
{"refreshToken":"<refresh token evela ku-/login>"}Isibonelo se-response
{"ok":true,"token":"<JWT entsha>","refreshToken":"<refresh token entsha>"}Amakhodi amaphutha
400 VALIDATION_ERROR — Ithokheni ye-refresh ishoda, ayisebenzi, iphelelwe isikhathi noma yasivele isetshenzisiwe.Ukuziphatha okuhlolwe
I-refresh-token esebenzayo inikeza ipheya elisha lamathokheni; ithokheni engasebenzi inikeza i-400 `VALIDATION_ERROR`.
Ukuqinisekiswa
POST /api/auth/loginIngena umsebenzisi ngekheli le-imeyili noma igama lokusebenzisa nephasiwedi futhi ikhiphe ithokheni yokufinyelela (JWT) kanye nethokheni ye-refresh.POST /api/auth/forgot-passwordIqala ukusetha kabusha iphasiwedi: uma i-akhawunti enekheli le-imeyili elinikeziwe ikhona, ithola i-imeyili enesixhumanisi sokusetha kabusha.POST /api/auth/reset-passwordIsetha iphasiwedi entsha ngethokheni ye-reset evela ku-imeyili yokusetha kabusha.POST /api/auth/sso/exchangeIsinyathelo sokugcina sokungena nge-SSO (SAML/OIDC): ishintshanisa ikhodi yokungenise eyodwa evela ekuqondisweni kabusha ngethokheni yokufinyelela nethokheni ye-refresh.