Khôi phục người dùng

Endpoint: POST /api/v6.1/user/restore

Mô tả: API dùng để khôi phục lại user đã bị xóa hoặc vô hiệu hóa trong hệ thống CRM. Khi khôi phục, có thể đồng thời thiết lập lại phòng ban, vai trò nghiệp vụ, nhóm phân quyền và mật khẩu đăng nhập cho user.

---

Yêu cầu

Phương thức: POST

Headers:

Content-Type: application/json
X-API-KEY: <api-key-của-bạn>

---

Body Parameters

{
  "user_username": "example_user",
  "department_name": "Phòng kinh doanh",
  "user_role_name": "Nhân viên",
  "acl_role_name": "Nhóm Marketing",
  "plain_password": "Example@123",
  "repeat_plain_password": "Example@123"
}

---

Mô tả các trường (Body)

Trường	Kiểu dữ liệu	Bắt buộc	Mô tả
user_id	integer	✔	ID user cần khôi phục
user_username	string	✔	Tên đăng nhập của user cần khôi phục
department_name	string	✔	Phòng ban sau khi khôi phục
user_role_name	string	✔	Vai trò nghiệp vụ sau khi khôi phục
acl_role_name	string	✔	Nhóm phân quyền (ACL Role) sau khi khôi phục
plain_password	string	✔	Mật khẩu mới cho user sau khi khôi phục
repeat_plain_password	string	✔	Nhập lại mật khẩu mới

---

Phản hồi

Trạng thái: 200 OK

Cấu trúc phản hồi (tham khảo)

{
  "message": "Khôi phục user thành công",
  "user_username": "example_user"
}

⚠️ Nội dung response thực tế có thể thay đổi tùy cấu hình hệ thống.

---

Ghi chú

• Chỉ cần cung cấp một trong hai: user_id hoặc user_username (không gửi đồng thời).
• acl_role_name, department_name, user_role_name phải tồn tại sẵn trong hệ thống.

---

Ví dụ cURL

curl --location 'https://<ten-mien>/api/v6.1/user/restore' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data-raw '{
  "user_username": "example_user",
  "department_name": "Phòng kinh doanh",
  "user_role_name": "Nhân viên",
  "acl_role_name": "Nhóm Marketing",
  "plain_password": "Example@123",
  "repeat_plain_password": "Example@123"
}'

---

Xử lý lỗi

Mã lỗi	Mô tả
400	Thiếu hoặc sai tham số đầu vào
401	Không được xác thực – sai hoặc thiếu API key
404	Không tìm thấy user hoặc user chưa bị vô hiệu hóa
500	Lỗi hệ thống nội bộ