获取部门成员
描述
查询指定部门下的所有成员信息
使用须知
开发前,请仔细阅读开发指南。
- POST请求头
{"Authorization": "Bearer YOUR_APIKEY"}
YOUR_APIKEY
请阅读开发指南了解。
接口URL
POST - /openapi/v1/department/member_list
请求参数
参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
---|---|---|---|---|
dept_id | 5f0d7cf9f4361283774fcac4 | String | 是 | 部门id |
请求示例
{
"dept_id": "5f0d7cf9f4361283774fcac4"
}
响应参数
参数名 | 示例值 | 参数类型 | 参数描述 |
---|---|---|---|
users | - | Object | |
users.user_id | 57c38102d8e647dcee87befc | String | 成员id |
users.name | 测试 | String | 名称 |
users.account | user_dehgal52997 | String | 账号 |
users.country_code | 86 | String | 手机区号 |
users.mobile | - | String | 手机号 |
users.email | - | String | 邮箱 |
users.category | 2 | String | 成员状态(-1表示被邀请的人尚未同意其邀请,同意后自动变为2,0表示团队创建者,2表示普通成员,-2离职成员) |
users.mobilestatus | 1 | String | 手机验证状态, 0(未验证) 1(已验证) |
users.emailstatus | 1 | String | 邮箱验证状态, 0(未验证) 1(已验证) |
users.uniqueid | WangXieaoMei1 | String | 企业内用户ID |
users.remark | - | String | 成员的备注信息 |
users.title | - | String | 成员的职称(旧职称字段已废弃) |
users.departments | [] | Array | 所属部门id |
users.main_department | 51d1177b964603db9e60a962 | String | 主部门id |
users.job_title | - | Array | 职称信息 |
users.job_title.dept_id | 51d1177b964603db9e60a962 | String | 部门id |
users.job_title.job_title | 组长 | String | 职称 |
users.roles | [] | Array | 所属角色组id |
响应数据样例
{
"users": [
{
"user_id": "5043f034699af3458734f91c",
"name": "李四",
"account": "user_wlsbap89940",
"country_code": "86",
"mobile": "18911111112",
"email": "123456@qq.com",
"category": "2",
"mobilestatus": "1",
"emailstatus": "1",
"uniqueid": "CeShi",
"remark": "12月2日加入",
"title": "主管",
"departments": [
"5f0d7cf9f4361283774fcac4"
],
"main_department": "5f0d7cf9f4361283774fcac4",
"job_title": [
{
"dept_id": "51d1177b964603db9e60a962",
"job_title": "组长"
}
],
"roles": [
"525fb26fdcb1d02adda3dc6d",
"5ee8f9e0706af569e58b1cfa"
]
}
]
}