服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
应用授权
回调通知
授权通知事件
授权通知事件
最后更新:2024/09/10

目录

  • 授权成功通知
  • 变更授权通知
  • 取消授权通知
  • 授权成功通知

    从企业微信应用市场发起授权时,企业微信后台会推送授权成功通知。

    从第三方服务商网站发起的应用授权流程,由于授权完成时会跳转第三方服务商管理后台,因此不会通过此接口向第三方服务商推送授权成功通知。

    请求方式:POST(HTTPS
    请求地址:https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

    请求包体:

    <xml>
    	<SuiteId><![CDATA[ww4asffe9xxx4c0f4c]]></SuiteId>
    	<AuthCode><![CDATA[AUTHCODE]]></AuthCode>
    	<InfoType><![CDATA[create_auth]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<State><![CDATA[123]]></State>
    	<ExtraInfo></ExtraInfo>
    </xml>
    服务商的响应必须在1000ms内完成,以保证用户安装应用的体验。建议在接收到此事件时,先记录下AuthCode,并立即回应企业微信,之后再做相关业务的处理。

    参数说明:

    参数说明
    SuiteId第三方应用的SuiteId或者代开发应用模板id
    AuthCode临时授权码,最长为512字节。用于获取企业永久授权码。10分钟内有效
    InfoTypecreate_auth
    TimeStamp时间戳
    State构造授权链接指定的state参数
    ExtraInfo额外信息,部分场景会携带,在其他文档中分别描述

    变更授权通知

    当授权方(即授权企业)在企业微信管理端的授权管理中,修改了对应用的授权后,企业微信服务器推送变更授权通知。支持第三方应用以及代开发应用。
    服务商接收到变更通知之后,需自行调用获取企业授权信息获取应用权限详情进行授权内容变更比对。

    触发授权通知路径包括:

    (1)应用的可见范围
    (2)禁用或者重新启用代开发应用
    (3)切换第三方应用授权模式:从管理员授权切换为成员授权或者成员授权切换为管理员授权
    (4)修改应用权限

    请求方式:POST(HTTPS
    请求地址:https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

    请求包体:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99exxx0f4c]]></SuiteId>
    	<InfoType><![CDATA[change_auth]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
    	<State><![CDATA[abc]]></State>
    	<ExtraInfo></ExtraInfo>
    </xml>
    服务商的响应必须在1000ms内完成,以保证用户变更授权的体验。建议在接收到此事件时,立即回应企业微信,之后再做相关业务的处理。

     

    参数说明:

    参数说明
    SuiteId第三方应用的SuiteId或者代开发应用模板id
    InfoTypechange_auth
    TimeStamp时间戳
    AuthCorpId授权方的corpid
    State构造授权链接指定的state参数
    ExtraInfo额外信息,部分场景会携带,在其他文档中分别描述

    取消授权通知

    当授权方(即授权企业)在企业微信管理端的授权管理中,取消了对应用的授权托管后,企业微信后台会推送取消授权通知。
    请求方式:POST(HTTPS
    请求地址:https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

    请求包体:

    <xml>
    	<SuiteId><![CDATA[ww4asffe99e54cxxxx]]></SuiteId>
    	<InfoType><![CDATA[cancel_auth]]></InfoType>
    	<TimeStamp>1403610513</TimeStamp>
    	<AuthCorpId><![CDATA[wxf8b4f85fxx794xxx]]></AuthCorpId>
    </xml>
    服务商的响应必须在1000ms内完成,以保证用户取消授权的体验。建议在接收到此事件时,立即回应企业微信,之后再做相关业务的处理。注意,服务商收到取消授权事件后,应当确保删除该企业所有相关的数据。

    参数说明:

    参数说明
    SuiteId第三方应用的SuiteId或者代开发应用模板id
    InfoTypecancel_auth
    TimeStamp时间戳
    AuthCorpId授权方企业的corpid

     

    上一篇推送suite_ticket
    下一篇重置永久授权码通知
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们