POST/api/auth/refresh

செல்லுபடியான புதுப்பிப்பு டோக்கனை புதிய அணுகல் டோக்கன் மற்றும் புதுப்பிப்பு டோக்கனின் ஜோடியுடன் மாற்றுகிறது.

சமீபத்தில் பெறப்பட்ட `refreshToken` ஐ JSON பகுதியில் அனுப்பவும். பதிலில் ஒரு புதிய `token` மற்றும் ஒரு புதிய `refreshToken` அடங்கும். ஒவ்வொரு புதுப்பிப்பு டோக்கனையும் ஒரே ஒரு முறை மட்டுமே பயன்படுத்த முடியும், இயல்பாக ஏழு நாட்களுக்கு செல்லுபடியாகும்; ஒவ்வொரு அழைப்புக்குப் பிறகும் புதிய டோக்கனைச் சேமித்து பழையதை நிராகரிக்கவும். விடுபட்ட, தவறான, காலாவதியான அல்லது ஏற்கெனவே பயன்படுத்திய புதுப்பிப்பு டோக்கன் 400 `VALIDATION_ERROR` ஐ ஏற்படுத்தும். அப்போது பயனர் `POST /api/auth/login` மூலம் மீண்டும் உள்நுழைய வேண்டும். புதுப்பிப்பு டோக்கன் பயன்பாட்டில் நுகரப்படுவதால், கிளையன்ட் இணை புதுப்பிப்புகளைத் தவிர்க்க வேண்டும்.

கண்ணோட்டம்

அழைப்பு: POST /api/auth/refresh. இந்த எண்ட்பாயிண்ட் Zentor App API-யின் “அங்கீகாரம்” குழுவைச் சேர்ந்தது. இது பொதுவில் அணுகக்கூடியது; அங்கீகாரம் (authentication) தேவையில்லை. இந்த அழைப்பு idempotent அல்ல: ஒவ்வொரு வெற்றிகரமான அழைப்பும் செயலை மீண்டும் தூண்டும். கட்டாய அளவுருக்கள்: refreshToken (பாடி). ஆவணப்படுத்தப்பட்ட பிழை நிலைகள்: 400 VALIDATION_ERROR. கீழே உள்ள மாதிரி பதில், JSON வடிவில் வெற்றிகரமான பதிலின் கட்டமைப்பைக் காட்டுகிறது.

அங்கீகாரம் & பாதுகாப்பு

அங்கீகாரம் தேவையில்லை

Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): இல்லை

அளவுருக்கள்

refreshToken(body, string, கட்டாயம்)— கடைசியாக வெளியிடப்பட்ட புதுப்பிப்பு டோக்கன்

எடுத்துக்காட்டுக் கோரிக்கை

{"refreshToken":"<Refresh-Token, /login இலிருந்து பெறப்பட்டது>"}

எடுத்துக்காட்டுப் பதில்

{"ok":true,"token":"<புதிய JWT>","refreshToken":"<புதிய Refresh-Token>"}

பிழைக் குறியீடுகள்

400 VALIDATION_ERROR — புதுப்பிப்பு டோக்கன் விடுபட்டது, தவறானது, காலாவதியானது அல்லது ஏற்கெனவே பயன்படுத்தப்பட்டது.

சரிபார்க்கப்பட்ட நடத்தை

செல்லுபடியான புதுப்பிப்பு டோக்கன் புதிய டோக்கன் ஜோடியைத் திருப்பும்; தவறான டோக்கன் 400 `VALIDATION_ERROR` ஐத் திருப்பும்.

அங்கீகாரம்

POST /api/auth/loginமின்னஞ்சல் முகவரி அல்லது பயனர்பெயர் மற்றும் கடவுச்சொல் மூலம் பயனரை உள்நுழைவு செய்து, ஒரு அணுகல் டோக்கன் (JWT) மற்றும் ஒரு புதுப்பிப்பு டோக்கனை வெளியிடுகிறது.POST /api/auth/forgot-passwordகடவுச்சொல் மீட்டமைப்பைத் தொடங்குகிறது: கொடுக்கப்பட்ட மின்னஞ்சல் முகவரியுடன் கணக்கு இருந்தால், அது மீட்டமைப்பு இணைப்புடன் ஒரு மின்னஞ்சலைப் பெறும்.POST /api/auth/reset-passwordகடவுச்சொல் மீட்டமைப்பு மின்னஞ்சலிலுள்ள மீட்டமைப்பு டோக்கனைப் பயன்படுத்தி புதிய கடவுச்சொல்லை அமைக்கிறது.POST /api/auth/sso/exchangeSSO உள்நுழைவின் (SAML/OIDC) இறுதிப் படி: திருப்பிவிடுதலிலிருந்து ஒருமுறை பயன்படும் குறியீட்டை அணுகல் டோக்கன் மற்றும் புதுப்பிப்பு டோக்கனுடன் மாற்றுகிறது.

சார்ந்த கட்டுரைகள்

உள்நுழைவு மற்றும் ஒருங்கிணைப்பு வழிகளைப் புரிந்துகொள்ளுதல்நீங்கள் எவ்வாறு பாதுகாப்பாக உள்நுழைவது - மற்றும் Zentor App-ஐ உங்கள் அமைப்புகளுடன் இணைக்கும் மூன்று வழிகள்.IP, டொமைன் மற்றும் நாட்டு அணுகல் விதிகளை உருவாக்குதல்உங்கள் சொந்த அணுகல் விதிகளை உருவாக்குதல், சோதனை முறையில் கண்காணித்தல், 24 மணி நேரத்திற்குப் பிறகு செயல்படுத்துதல்.
← அங்கீகாரம்