Thêm mới người dùng

Endpoint: POST /api/v6.1/user

Mô tả: API dùng để tạo mới một user trong hệ thống CRM. Cho phép khai báo thông tin đăng nhập, thông tin liên hệ, phòng ban và phân quyền ban đầu 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

⚠️ Dữ liệu bên dưới là ví dụ minh hoạ, không chứa thông tin thật.

{
  "user_username": "exampleuser",
  "contact_first_name": "Nguyen",
  "contact_last_name": "Van A",
  "plain_password": "Example@123",
  "repeat_plain_password": "Example@123",
  "contact_gender": 1,
  "department_name": "Phòng kinh doanh",
  "user_role_name": "Nhân viên",
  "user_email": "[email protected]",
  "contact_mobile": "0900000000",
  "acl_role_name": "Nhóm Nhân viên"
}

---

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

Trường	Kiểu dữ liệu	Bắt buộc	Mô tả
user_username	string	✔	Tên đăng nhập (duy nhất)
contact_first_name	string	✔	Họ + tên đệm người dùng
contact_last_name	string	✔	Tên người dùng
plain_password	string	✔	Mật khẩu đăng nhập (dạng plain, sẽ được mã hoá khi lưu)
repeat_plain_password	string	✔	Nhập lại mật khẩu (phải trùng plain_password)
contact_gender	integer	✔	Giới tính (1 = Nam, 2 = Nữ)
department_name	string	✔	Tên phòng ban
user_role_name	string	✔	Vai trò nghiệp vụ của user
user_email	string	✖	Email người dùng
contact_mobile	string	✖	Số điện thoại liên hệ
acl_role_name	string	✔	Nhóm phân quyền (ACL Role)

---

Phản hồi

Trạng thái: 200 OK

Cấu trúc phản hồi

{
  "message": "Thêm mới thành công",
  "identity": 1001,
  "user_username": "example_user"
}

---

Ghi chú

• user_username và user_email phải không trùng trong hệ thống.
• Mật khẩu chỉ dùng khi tạo/sửa user, không bao giờ trả về trong response.
• acl_role_name phải tồn tại sẵn trong hệ thống phân quyền.
• department_name và user_role_name sẽ được map theo cấu hình nội bộ.

---

Ví dụ cURL

curl --location 'https://<ten-mien>/api/v6.1/user' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data-raw '{
  "user_username": "example_user",
  "contact_first_name": "Nguyen",
  "contact_last_name": "Van A",
  "plain_password": "Example@123",
  "repeat_plain_password": "Example@123",
  "contact_gender": 1,
  "department_name": "Phòng kinh doanh",
  "user_role_name": "Nhân viên",
  "user_email": "[email protected]",
  "contact_mobile": "0900000000",
  "acl_role_name": "Nhóm Nhân viên"
}'

---

Xử lý lỗi

Mã lỗi	Mô tả
400	Dữ liệu không hợp lệ hoặc thiếu trường bắt buộc
401	Không được xác thực – sai hoặc thiếu API key
500	Lỗi hệ thống nội bộ