|
企业微信应用安装, 需要对成员进行各种操作, 在此就需要对成员进行应用授权,成员授权应用,主要从一下几点进行讲解
成员授权模式的接口变更
企业微信尽可能做到两种授权模式的兼容,以在第三方服务商不做任何修改的情况下,也能平稳地为企业用户提供服务。尽管如此,我们在成员授权模式下提供了新的能力,例如第三方应用可以给不在可见范围的成员推送模板消息,这在管理员授权模式下是不允许的。所以我们建议第三方服务商关注我们的接口变更情况,包括新增与变更的接口,以提供更好的用户体验。以下是具体的变更情况。
一、 新增的服务端API
接口 支持何种授权模式
1. 获取成员授权列表 成员授权
2. 查询成员用户是否已授权 成员授权
3. 获取选人ticket对应的用户 成员授权
二、 新增的JS-API
接口 支持何种授权模式
1. 返回ticket的选人接口 成员授权 或 管理员授权
2. 创建群聊并发送消息 成员授权 或 管理员授权
3. 打开群聊并发送消息 成员授权 或 管理员授权
注:支持成员授权模式,是指在成员授权模式下才允许调用接口;同时支持成员与管理员授权模式,则指无论哪种授权模式下都允许调用接口。
三、 变更的服务端API
接口 变更点
1. 获取永久授权码 新增返回字段auth_info.agent.auth_mode,表示授权模式,0为管理员授权,1为成员授权
2. 获取企业授权信息 新增返回字段auth_info.agent.auth_mode,表示授权模式,0为管理员授权,1为成员授权
3. 发送应用模板消息 在发送应用消息接口的基础上,第三方应用支持一种新的消息类型:模板消息;成员授权模式下,可对未授权的用户推送模板消息
4. 获取应用的管理员列表 成员授权模式下,不返回系统管理员列表,只返回管理员配置的应用管理员列表
5. 读取成员 成员授权模式下,读取成员时所属部门列表、主部门都只返回根部门id,即1;不返回部门内order
6. 获取部门成员 成员授权模式下,应用无任何部门权限,调用时将返回60011错误
7. 获取部门成员详情 成员授权模式下,应用无任何部门权限,调用时将返回60011错误
8. 获取部门列表 成员授权模式下,应用无任何部门权限,调用时将返回60011错误
四、 变更的回调事件
回调事件 变更点
1. 成员通知事件 成员授权模式下,用户所属部门或者主部门只返回根部门id,即1
2. 变更授权通知 管理员对应用的授权模式进行切换时,会触发变更授权通知的回调
|
|