POST/api/auth/reset-password
கடவுச்சொல் மீட்டமைப்பு மின்னஞ்சலிலுள்ள மீட்டமைப்பு டோக்கனைப் பயன்படுத்தி புதிய கடவுச்சொல்லை அமைக்கிறது.
JSON பகுதியில் `token` (மீட்டமைப்பு மின்னஞ்சல் இணைப்பிலிருந்து) மற்றும் புதிய `password` ஐ அனுப்பவும். இதற்கு உள்நுழைவு தேவையில்லை. கடவுச்சொல் Zentor App-இன் குறைந்தபட்ச தேவைகளைப் பூர்த்தி செய்ய வேண்டும். வெற்றியடைந்தால் சர்வர் `{"ok":true}` உடன் பதிலளிக்கிறது; பின்னர் பயனர் புதிய கடவுச்சொல்லுடன் உள்நுழைகிறார். தவறான, காலாவதியான அல்லது ஏற்கெனவே பயன்படுத்திய டோக்கன், மற்றும் குறைந்தபட்ச தேவைகளை பூர்த்தி செய்யாத கடவுச்சொல், 400 `VALIDATION_ERROR` ஐ ஏற்படுத்தும். வெற்றிகரமான பயன்பாட்டிற்குப் பிறகு டோக்கன் நுகரப்படும்; மேலும் மாற்றத்திற்கு `POST /api/auth/forgot-password` மூலம் புதிய செயல்முறையைத் தொடங்கவும். இந்த எண்ட்பாயிண்ட் ஒரு IP முகவரிக்கு 15 நிமிடங்களுக்கு 10 கோரிக்கைகளாக வரையறுக்கப்பட்டுள்ளது. டோக்கன் மற்றும் கடவுச்சொல்லை ரிக்வெஸ்ட் பகுதியில் HTTPS மூலம் மட்டுமே அனுப்பவும், URL அளவுருவாக ஒருபோதும் அனுப்ப வேண்டாம்.
கண்ணோட்டம்
அழைப்பு: POST /api/auth/reset-password. இந்த எண்ட்பாயிண்ட் Zentor App API-யின் “அங்கீகாரம்” குழுவைச் சேர்ந்தது. இது பொதுவில் அணுகக்கூடியது; அங்கீகாரம் (authentication) தேவையில்லை. இந்த அழைப்பு idempotent அல்ல: ஒவ்வொரு வெற்றிகரமான அழைப்பும் செயலை மீண்டும் தூண்டும். கட்டாய அளவுருக்கள்: token (பாடி), password (பாடி). ஆவணப்படுத்தப்பட்ட பிழை நிலைகள்: 400 VALIDATION_ERROR. கீழே உள்ள மாதிரி பதில், JSON வடிவில் வெற்றிகரமான பதிலின் கட்டமைப்பைக் காட்டுகிறது.
அங்கீகாரம் & பாதுகாப்பு
அங்கீகாரம் தேவையில்லை
Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): இல்லை
அளவுருக்கள்
token(body, string, கட்டாயம்)— மின்னஞ்சலிலிருந்து மீட்டமைப்பு டோக்கன்password(body, string, கட்டாயம்)— புதிய கடவுச்சொல்எடுத்துக்காட்டுக் கோரிக்கை
{"token":"<மீட்டமைப்பு மின்னஞ்சலிலிருந்து பெற்ற டோக்கன்>","password":"PuthiyaPathukappanaKadavuchol!"}எடுத்துக்காட்டுப் பதில்
{"ok":true}பிழைக் குறியீடுகள்
400 VALIDATION_ERROR — டோக்கன் தவறானது, காலாவதியானது அல்லது ஏற்கெனவே பயன்படுத்தப்பட்டது, அல்லது கடவுச்சொல் குறைந்தபட்ச தேவைகளைப் பூர்த்தி செய்யவில்லை.சரிபார்க்கப்பட்ட நடத்தை
தவறான டோக்கன் 400 `VALIDATION_ERROR` ஐத் திருப்பும். வெற்றி நிலை (200 `{"ok":true}`) ஆவணப்படுத்தப்பட்ட செயல்முறையின் அடிப்படையில் விவரிக்கப்பட்டுள்ளது.
அங்கீகாரம்
POST /api/auth/loginமின்னஞ்சல் முகவரி அல்லது பயனர்பெயர் மற்றும் கடவுச்சொல் மூலம் பயனரை உள்நுழைவு செய்து, ஒரு அணுகல் டோக்கன் (JWT) மற்றும் ஒரு புதுப்பிப்பு டோக்கனை வெளியிடுகிறது.POST /api/auth/refreshசெல்லுபடியான புதுப்பிப்பு டோக்கனை புதிய அணுகல் டோக்கன் மற்றும் புதுப்பிப்பு டோக்கனின் ஜோடியுடன் மாற்றுகிறது.POST /api/auth/forgot-passwordகடவுச்சொல் மீட்டமைப்பைத் தொடங்குகிறது: கொடுக்கப்பட்ட மின்னஞ்சல் முகவரியுடன் கணக்கு இருந்தால், அது மீட்டமைப்பு இணைப்புடன் ஒரு மின்னஞ்சலைப் பெறும்.POST /api/auth/sso/exchangeSSO உள்நுழைவின் (SAML/OIDC) இறுதிப் படி: திருப்பிவிடுதலிலிருந்து ஒருமுறை பயன்படும் குறியீட்டை அணுகல் டோக்கன் மற்றும் புதுப்பிப்பு டோக்கனுடன் மாற்றுகிறது.