/ 
QQ-weixin-work-v0.10
River stage zero No dependents
/ QQ::weixin::work::security::vip

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

请求说明：

该接口用于分配应用可见范围内企业成员的高级功能。

请求包结构体为：

{
  "jobid": "xxx"
}

参数说明：

	参数	            必须	说明
    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

请求说明：

请求包结构体为：

{
  "jobid": "xxx"
}

参数说明：

	参数	            必须	说明
    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列表