Cập nhật người dùng

Endpoint: PUT /api/v6.1/user

Mô tả: API dùng để cập nhật thông tin của user đã tồn tại trong hệ thống CRM. Cho phép cập nhật thông tin cá nhân, thông tin liên hệ, phòng ban, vai trò nghiệp vụ và mật khẩu (nếu cần).

---

Yêu cầu

Phương thức: PUT

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 Updated",
  "plain_password": "Example@123",
  "repeat_plain_password": "Example@123",
  "contact_gender": 1,
  "department_name": "Phòng kinh doanh",
  "user_role_name": "Phó phòng",
  "user_email": "[email protected]",
  "contact_mobile": "0900000001"
}

---

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 của user cần cập nhật (định danh duy nhất)
contact_first_name	string	✔	Tên người dùng
contact_last_name	string	✔	Họ người dùng
plain_password	string	✖	Mật khẩu mới (nếu muốn thay đổi)
repeat_plain_password	string	✖	Nhập lại mật khẩu mới
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 user
contact_mobile	string	✖	Số điện thoại liên hệ

---

Phản hồi

Trạng thái: 200 OK

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

{
  "message": "Cập nhật thành công",
  "user_username": "example_user"
}

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

---

Ghi chú

• user_username là bắt buộc để xác định user cần cập nhật.
• Chỉ những field được gửi lên mới được cập nhật, các field khác giữ nguyên.
• Nếu không truyền plain_password, mật khẩu hiện tại sẽ không bị thay đổi.
• user_email khi cập nhật phải không trùng với user khác trong hệ thống.

---

Ví dụ cURL

curl --location --request PUT '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 Updated",
  "plain_password": "Example@123",
  "repeat_plain_password": "Example@123",
  "contact_gender": 1,
  "department_name": "Phòng kinh doanh",
  "user_role_name": "Phó phòng",
  "user_email": "[email protected]",
  "contact_mobile": "0900000001"
}'

---

Xử lý lỗi

Mã lỗi	Mô tả
400	Dữ liệu không hợp lệ hoặc sai định dạng
401	Không được xác thực – sai hoặc thiếu API key
404	Không tìm thấy user cần cập nhật
500	Lỗi hệ thống nội bộ