HRMNhân viên
Khôi phục tài khoản
Quy trình khôi phục mật khẩu bao gồm khởi tạo xác thực và cập nhật mật khẩu mới.
1. Khởi tạo khôi phục mật khẩu
Gửi mã xác thực OTP đến email người dùng để bắt đầu quy trình khôi phục mật khẩu.
Endpoint
POST /v1/users/recoveryinit
Body Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
email | string | Có | Email người dùng |
Response Schema
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"passport_id": "8c6600c3-...",
"full_name": "Nguyễn Văn A",
"email": "[email protected]",
"otp_length": 6,
"date_created": 1640995200,
"date_expired": 1640995500,
"metadata": {
"action": "recovery"
}
}2. Hoàn tất khôi phục mật khẩu
Xác thực OTP và thiết lập mật khẩu mới cho tài khoản.
Endpoint
POST /v1/users/recoveryfinish
Body Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
email | string | Có | Email người dùng |
password | string | Có | Mật khẩu mới (tối thiểu 7 ký tự) |
otp | string | Có | Mã OTP nhận được qua email |
passport_id | string | Có | ID passport nhận được từ bước Init |
Response Schema
Trả về object User của người dùng đã được cập nhật mật khẩu.
Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 422 | error_email_required | Thiếu email |
| 422 | error_email_invalid | Định dạng email không hợp lệ |
| 422 | error_email_not_existed | Email không tồn tại trong hệ thống |
| 422 | error_password_length_invalid | Mật khẩu quá ngắn |
| 422 | error_passport_id_required | Thiếu ID passport |
| 422 | error_otp_required | Thiếu mã OTP |
| 422 | error_passport_otp_not_found | OTP đã hết hạn hoặc không tồn tại |
| 422 | error_otp_invalid | Mã OTP không chính xác |
| 500 | error_save_passport | Lỗi lưu trữ thông tin xác thực |
| 500 | error_update_password | Lỗi khi cập nhật mật khẩu mới |