请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/linkedcorp/user/simplelist?access_token=ACCESS_TOKEN
请求包体:
{
"department_id": "LINKEDID/DEPARTMENTID",
"fetch_child": true
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
department_id | 是 | 该字段用的是互联应用可见范围接口返回的department_ids参数,用的是 linkedid + ’/‘ + department_id 拼成的字符串 |
fetch_child | 否 | 是否递归获取子部门下面的成员:1-递归获取,0-只获取本部门,不传默认只获取本部门成员 |
权限说明:
仅自建应用可调用,应用须拥有指定部门的查看权限。
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"userlist": [
{
"userid": "zhangsan",
"name": "张三",
"department": ["LINKEDID/1", "LINKEDID/2"],
"corpid": "xxxxxx"
},
{
"userid": "lisi",
"name": "李四",
"department": ["LINKEDID/1"],
"corpid": "xxxxxx"
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
userlist | 成员列表 |
userid | 成员UserID。对应管理端的帐号 |
name | 成员真实名称 |
department | 成员所属部门id列表,这个字段只会返回传入的department_id所属的互联企业里的部门id |
corpid | 所属企业的corpid |