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

บทความที่เกี่ยวข้อง

← การยืนยันตัวตน