部门
获取部门成员列表
复用现有的【组织-查找成员】
鉴权方式
个人访问令牌(PAT)由用户自行创建,用于以个人身份调用 API。
版本
请求地址
Path 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
department_id | string | 是 | 部门ID |
Header 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
Authorization | string | 是 | Bearer {{access_token}} |
HAP-Appid | string | 否 | 应用 id |
Query 参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
orgId | string | 否 | 组织ID,OAuth/PAT 鉴权不传 HAP-Appid 时必填,用于指定查询组织;传入 HAP-Appid 时可省略。 |
pageIndex | integer | 否 | 页码 |
pageSize | integer | 否 | 每页条数 |
响应参数
200成功| 名称 | 类型 | 描述 |
|---|---|---|
success | boolean | 是否调用成功 |
error_code | integer | 错误代码 |
error_msg | string | 错误消息 |
data | object | — |
data.total | integer | 部门总人数 |
data.pageIndex | integer | 当前页码 |
data.pageSize | integer | 每页条数 |
data.users | object[] | 部门成员列表 |
data.users.accountId | string | 用户ID |
data.users.fullname | string | 姓名 |
data.users.job | string | 用户在当前组织内担任的职位名称 |
data.users.isCharge | boolean | 是否为部门主管 |
data.users.workDescription | string | 工作职责文本 |
data.users.mobile | string | 脱敏手机号 |
data.users.email | string | 脱敏邮箱 |
curl -X GET "https://example.com/v3/departments/department_id/users"{ "success": true, "data": { "total": 1, "pageIndex": 1, "pageSize": 1, "users": [ { "accountId": "user_001", "fullname": "Alice", "job": "string", "isCharge": false, "workDescription": "string", "mobile": "138****5678", "email": "ali****@mail.com" } ] }, "error_code": 1}