POST/api/auth/reset-password
ตั้งรหัสผ่านใหม่ด้วย Reset Token จากอีเมลรีเซ็ตรหัสผ่าน
ส่ง `token` (จากลิงก์ในอีเมลรีเซ็ต) และ `password` ใหม่ใน JSON body ไม่จำเป็นต้องเข้าสู่ระบบสำหรับขั้นตอนนี้ รหัสผ่านต้องตรงตามข้อกำหนดขั้นต่ำของ Zentor App เมื่อสำเร็จ เซิร์ฟเวอร์จะตอบกลับด้วย `{"ok":true}` หลังจากนั้นผู้ใช้จะเข้าสู่ระบบด้วยรหัสผ่านใหม่ โทเค็นที่ไม่ถูกต้อง หมดอายุ หรือถูกใช้ไปแล้ว รวมถึงรหัสผ่านที่ไม่ตรงตามข้อกำหนดขั้นต่ำ จะทำให้เกิด 400 `VALIDATION_ERROR` โทเค็นจะถูกใช้หมดไปหลังจากใช้งานสำเร็จ หากต้องการเปลี่ยนอีกครั้ง ให้เริ่มกระบวนการใหม่ผ่าน `POST /api/auth/forgot-password` เอนด์พอยต์นี้จำกัดไว้ที่ 10 คำขอต่อ 15 นาทีต่อที่อยู่ IP ส่งโทเค็นและรหัสผ่านใน request body ผ่าน HTTPS เท่านั้น ห้ามส่งเป็นพารามิเตอร์ใน URL โดยเด็ดขาด
ภาพรวม
การเรียกใช้: POST /api/auth/reset-password เอนด์พอยต์นี้อยู่ในกลุ่ม “การยืนยันตัวตน” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้ไม่เป็นแบบ idempotent: การเรียกที่สำเร็จแต่ละครั้งจะทริกเกอร์การดำเนินการใหม่อีกครั้ง พารามิเตอร์ที่จำเป็น: token (body), password (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 VALIDATION_ERROR ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่
พารามิเตอร์
token(body, string, จำเป็น)— Reset Token จากอีเมลpassword(body, string, จำเป็น)— รหัสผ่านใหม่ที่ต้องการตั้งตัวอย่างคำขอ
{"token":"<โทเค็นจากอีเมลรีเซ็ต>","password":"NewSecurePassword!"}ตัวอย่างการตอบกลับ
{"ok":true}รหัสข้อผิดพลาด
400 VALIDATION_ERROR — โทเค็นไม่ถูกต้อง หมดอายุ หรือถูกใช้ไปแล้ว หรือรหัสผ่านไม่ตรงตามข้อกำหนดขั้นต่ำพฤติกรรมที่ตรวจสอบแล้ว
โทเค็นที่ไม่ถูกต้องจะได้รับ 400 `VALIDATION_ERROR` กรณีสำเร็จ (200 `{"ok":true}`) อธิบายตามขั้นตอนที่มีการบันทึกไว้
การยืนยันตัวตน
POST /api/auth/loginยืนยันตัวตนผู้ใช้ด้วยอีเมลหรือชื่อผู้ใช้และรหัสผ่าน และออก Access Token (JWT) พร้อม Refresh TokenPOST /api/auth/refreshแลก Refresh Token ที่ถูกต้องเป็นคู่ Access Token และ Refresh Token ใหม่POST /api/auth/forgot-passwordเริ่มการรีเซ็ตรหัสผ่าน: หากมีบัญชีที่ใช้อีเมลที่ระบุอยู่ บัญชีนั้นจะได้รับอีเมลพร้อมลิงก์สำหรับรีเซ็ตPOST /api/auth/sso/exchangeขั้นตอนสุดท้ายของการเข้าสู่ระบบด้วย SSO (SAML/OIDC): แลกโค้ดใช้ครั้งเดียวจากการเปลี่ยนเส้นทางเป็น Access Token และ Refresh Token