Name
QQ::weixin::work::security::vip
DESCRIPTION
高级功能账号管理
FUNCTION
submit_batch_add_job(access_token, hash);
分配高级功能账号 最后更新：2024/01/24
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/99503
请求说明：
该接口用于分配应用可见范围内企业成员的高级功能。
请求包结构体为：
{
"userid_list": ["zhangsan","lisi","wangwu","zhaoliu"]
}
|
参数说明：
参数 必须 说明
access_token 是 调用接口凭证
userid_list 是 要分配高级功能的企业成员userid列表，单次操作最大限制100个
|
权限说明：
应用类型 权限要求
自建应用 配置到「安全与管理 - 可调用接口的应用」中
代开发应用 暂不支持
第三方应用 暂不支持
|
RETURN 返回结果：
{
"errcode": 0,
"errmsg": "ok",
"jobid": "xxx",
"invalid_userid_list":["zhaoliu"]
}
|
RETURN 参数说明：
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
jobid 批量分配高级功能的任务id
invalid_userid_list 非法的userid 列表，不在应用可见范围的useri以及无法识别的userid
|
batch_add_job_result(access_token, hash);
查询分配高级功能账号结果 最后更新：2024/01/24
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/99503
请求说明：
该接口用于分配应用可见范围内企业成员的高级功能。
请求包结构体为：
参数说明：
参数 必须 说明
access_token 是 调用接口凭证
jobid 是 批量分配高级功能的任务id
|
权限说明：
应用类型 权限要求
自建应用 配置到「安全与管理 - 可调用接口的应用」中
代开发应用 暂不支持
第三方应用 暂不支持
|
RETURN 返回结果：
{
"errcode": 0,
"errmsg": "ok",
"jobid": "xxx",
"invalid_userid_list":["zhaoliu"]
}
|
RETURN 参数说明：
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
job_result 执行任务结果详情
succ_userid_list 分配成功的用户列表，包括之前已经分配过的用户
fail_userid_list 分配失败的用户列表
|
submit_batch_del_job(access_token, hash);
取消高级功能账号 最后更新：2024/01/24
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/99505
请求说明：
该接口用于撤销分配应用可见范围企业成员的高级功能。
请求包结构体为：
{
"userid_list": ["zhangsan","lisi","wangwu","zhaoliu"]
}
|
参数说明：
参数 必须 说明
access_token 是 调用接口凭证
userid_list 是 要撤销分配高级功能的企业成员userid列表，单次操作最多限制100个
|
权限说明：
应用类型 权限要求
自建应用 配置到「安全与管理 - 可调用接口的应用」中
代开发应用 暂不支持
第三方应用 暂不支持
|
RETURN 返回结果：
{
"errcode": 0,
"errmsg": "ok",
"jobid": "xxx",
"invalid_userid_list":["zhaoliu"]
}
|
RETURN 参数说明：
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
job_result 执行任务结果详情
jobid 批量取消高级功能的任务id
invalid_userid_list 非法的userid 列表，不在应用可见范围的useri以及无法识别的userid
|
batch_del_job_result(access_token, hash);
查询取消高级功能账号结果 最后更新：2024/01/24
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/99505
请求说明：
请求包结构体为：
参数说明：
参数 必须 说明
access_token 是 调用接口凭证
jobid 是 批量取消高级功能的任务id
|
权限说明：
应用类型 权限要求
自建应用 配置到「安全与管理 - 可调用接口的应用」中
代开发应用 暂不支持
第三方应用 暂不支持
|
RETURN 返回结果：
{
"errcode": 0,
"errmsg": "ok",
"job_result": {
"succ_userid_list":["zhangsan","lisi"],
"fail_userid_list":["wangwu"]
}
}
|
RETURN 参数说明：
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
job_result 执行任务结果详情
succ_userid_list 撤销分配成功的用户列表
fail_userid_list 撤销分配失败的用户列表
|
list(access_token, hash);
获取高级功能账号列表 最后更新：2024/01/24
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/99506
请求说明：
该接口用于查询企业已分配高级功能且在应用可见范围的账号列表。
请求包结构体为：
{
"cursor":"CURSOR",
"limit":2
}
|
参数说明：
参数 必须 说明
access_token 是 调用接口凭证
cursor 否 用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填
limit 否 用于分页查询，每次请求返回的数据上限。默认100，最大200
|
注意：不保证每次返回的数据刚好为指定limit，必须用返回的has_more判断是否继续请求
权限说明：
应用类型 权限要求
自建应用 配置到「安全与管理 - 可调用接口的应用」中
代开发应用 暂不支持
第三方应用 暂不支持
|
RETURN 返回结果：
{
"errcode": 0,
"errmsg": "ok",
"has_more":true,
"next_cursor":"GNIJIGEO",
"userid_list":["zhangsan","lisi"]
}
|
RETURN 参数说明：
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
has_more 是否还有更多数据未获取
next_cursor 下一次请求的cursor值
userid_list 符合条件的企业成员userid列表
|