Chi tiết người dùng

Endpoint: GET /api/v6.1/user

Mô tả: Lấy thông tin chi tiết một user theo đúng một trong hai tham số: user_id hoặc user_username.

---

Yêu cầu

Phương thức: GET

Headers:

X-API-KEY: <api-key-của-bạn>

---

Query Parameters

Tham số định danh (bắt buộc đúng một)

Tham số	Kiểu	Mô tả
user_id	integer (≥ 1)	ID của user
user_username	string	Tên đăng nhập

caution

Gửi cả hai user_id và user_username sẽ lỗi validation. Không gửi cái nào cũng lỗi.

Tham số tùy chọn

Tham số	Mô tả
fields	Danh sách trường cần lấy, phân cách bằng dấu phẩy (,)

Ví dụ fields:

id,user_username,display_name,department_name,user_avatar,user_email,contact_mobile

---

Phản hồi

Trạng thái: 200 OK

{
  "id": 12,
  "user_username": "nguyenvana",
  "display_name": "Nguyễn Văn A",
  "department_name": "Kinh doanh",
  "user_avatar": "https://...jpg",
  "user_email": "nguyenvana@gmail.com",
  "contact_mobile": "0901234567"
}

---

Mô tả các trường

Trường	Kiểu	Mô tả
id	integer	ID user
user_username	string	Tên đăng nhập
display_name	string	Tên hiển thị
department_name	string	Tên phòng ban
user_avatar	string (URL)	Ảnh đại diện
user_email	string	Email
contact_mobile	string	Số điện thoại liên hệ

---

Ghi chú

• Trả về object đơn, không phải mảng (khác danh sách user).
• Danh sách trả user_id / user_name; chi tiết nhận query user_id / user_username và trả id / user_username.
• Map: user_id (list) → user_id; user_name (list) → user_username.
• Nếu không truyền fields, hệ thống trả tập trường mặc định của public API.

---

Ví dụ cURL

Theo user_username:

curl --location 'https://<ten-mien>/api/v6.1/user?user_username=lambinhchi&fields=id,user_username,display_name,department_name,user_avatar,user_email,contact_mobile' \
--header 'X-API-KEY: <api-key>'

Theo user_id:

curl --location 'https://<ten-mien>/api/v6.1/user?user_id=12&fields=id,user_username,display_name,department_name,user_avatar,user_email,contact_mobile' \
--header 'X-API-KEY: <api-key>'

---

Xử lý lỗi

Mã lỗi	Mô tả
400	Thiếu cả hai / gửi cả hai user_id và user_username
401	Sai hoặc thiếu API key
403	Không có quyền truy cập API
404	Không tìm thấy user tương ứng
500	Lỗi hệ thống nội bộ