设置授权应用可见范围

调用该接口前提是开启通讯录迁移，收到授权成功通知后可调用。企业注册初始化安装应用后，应用默认可见范围为根部门。如需修改应用可见范围，服务商可以调用该接口设置授权应用的可见范围。该接口只能使用注册完成回调事件或者查询注册状态返回的access_token，调用设置通讯录同步完成后或者access_token超过30分钟失效（即解除通讯录锁定状态）则不能继续调用该接口。
文档ID: 14936
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/90583
https://open.work.weixin.qq.com/api/doc/90002/90151/90807

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/agent/set_scope?access_token=' \ --header 'Content-Type: application/json' \ --data-raw '{"agentid":1,"allow_user":["zhansan","lisi"],"allow_party":[1,2,3],"allow_tag":[1,2,3]}'

请求参数

Query 参数

access_token

必需

查询注册状态接口返回的access_token（跟注册完成回调事件的AccessToken参数一致，请注意与provider_access_token的区别）

示例值:

Body 参数application/json

agentid

integer <int32>

授权方应用id

必需

allow_tag

array[integer <int32>]

可选

应用可见范围（标签）若未填该字段，则清空可见范围中标签列表

allow_user

array[string]

可选

应用可见范围（成员）若未填该字段，则清空可见范围中成员列表

allow_party

array[integer <int32>]

可选

应用可见范围（部门）若未填该字段，则清空可见范围中部门列表

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

错误码

可选

invalidtag

array[integer <int32>]

非法标签列表

可选

errmsg

string

错误码对应的描述

可选

invalidparty

array[integer <int32>]

非法部门列表

可选

invaliduser

array[string]

非法成员列表

可选