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