用户
获取人员详细资料
复用现有的【组织-查找成员】
鉴权方式
个人访问令牌（PAT）由用户自行创建，用于以个人身份调用 API。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
user_id | string | 是 | 用户ID |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
Authorization | string | 是 | Bearer {{access_token}} |
HAP-Appid | string | 否 | 应用 id |
Query 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
orgId | string | 否 | 组织ID，OAuth/PAT 鉴权不传 HAP-Appid 时必填，用于指定查询组织；传入 HAP-Appid 时可省略。 |
响应参数
200成功| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
data | object | — |
data.accountId | string | 用户ID |
data.fullname | string | 姓名 |
data.jobNumber | string | 员工工号 |
data.avatar | string | 用户头像URL |
data.status | integer | 在职状态码 |
data.mainDepartment | object | 主属部门信息 |
data.mainDepartment.id | string | 部门ID |
data.mainDepartment.name | string | 部门名称 |
data.mainDepartment.path | string | 部门路径，格式：“最高级部门名称/.../ 父部门名称” |
data.subDepartments | object[] | 兼职部门列表 |
data.subDepartments.id | string | 部门ID |
data.subDepartments.name | string | 部门名称 |
data.subDepartments.path | string | 部门路径，格式：“最高级部门名称/.../ 父部门名称” |
data.job | string | 用户在当前组织内担任的职位名称 |
data.isCharge | boolean | 是否主管 |
data.superior | object | 直属上级/汇报对象 |
data.superior.accountId | string | 用户ID |
data.superior.fullname | string | 姓名 |
data.workDescription | string | 详尽工作职责文本 |
data.orgRoles | object[] | 所属企业级组织角色列表 |
data.orgRoles.id | string | HAP组织角色Id |
data.orgRoles.name | string | HAP组织角色名称 |
data.mobile | string | 脱敏手机号 |
data.email | string | 脱敏邮箱 |
curl -X GET "https://example.com/v3/users/user_id"{ "success": true, "data": { "accountId": "user_001", "fullname": "Alice", "jobNumber": "string", "avatar": "string", "status": 0, "mainDepartment": { "id": "dep_001", "name": "部门A", "path": "公司/部门A" }, "subDepartments": [ { "id": "dep_001", "name": "部门A", "path": "公司/部门A" } ], "job": "string", "isCharge": false, "superior": { "accountId": "user_001", "fullname": "Alice" }, "workDescription": "string", "orgRoles": [ { "id": "string", "name": "string" } ], "mobile": "138****5678", "email": "ali****@mail.com" }, "error_code": 1}