第三方服务商可以用此接口获取授权企业中某个第三方应用的管理员列表(不包括外部管理员),以便服务商在用户进入应用主页之后根据是否管理员身份做权限的区分。
该应用必须与SUITE_ACCESS_TOKEN对应的suiteid对应,否则没权限查看
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/service/get_admin_list?suite_access_token=SUITE_ACCESS_TOKEN
请求包体:
{
"auth_corpid": "auth_corpid_value",
"agentid": 1000046
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
auth_corpid | 是 | 授权方corpid |
agentid | 是 | 授权方安装的应用agentid |
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"admin":[
{"userid":"zhangsan","open_userid":"xxxxx","auth_type":1},
{"userid":"lisi","open_userid":"yyyyy","auth_type":0}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 错误码,0表示正常返回,可读取admin的管理员列表 |
errmsg | 错误说明 |
admin | 应用的管理员列表(不包括外部管理员),成员授权模式下,不返回系统管理员 |
userid | 管理员的userid |
open_userid | 管理员的open_userid |
auth_type | 该管理员对应用的权限:0=发消息权限,1=管理权限 |