第三方回调协议
推送suite_ticket协议
微信服务器会向套件的“系统事件接收URL”定时(每十分钟)推送ticket:
POST数据示例
{ <xml> <SuiteId><![CDATA[wxfc918a2d200c9a4c]]></SuiteId> <InfoType> <![CDATA[suite_ticket]]></InfoType> <TimeStamp>1403610513</TimeStamp> <SuiteTicket><![CDATA[asdfasfdasdfasdf]]></SuiteTicket> </xml> }
应用提供商在收到ticket推送后需要返回字符串success。
字段说明
参数 | 说明 |
---|---|
SuiteId | 应用套件的SuiteId |
InfoType | suite_ticket |
TimeStamp | 时间戳 |
SuiteTicket | Ticket内容 |
为了加强安全性,postdata中的xml将使用应用套件申请时的加解密key来进行加密,具体请见“使用回调模式”,注意需要将corpid替换为suiteid,并忽略AgentID参数
变更授权的通知
当授权方(即授权企业号)在企业号管理端的授权管理中,修改了对套件方的授权托管后,微信服务器会向应用提供商的套件事件接收 URL(创建套件时填写)推送变更授权通知。
开发者接收到变更通知之后,需自行调用 获取企业号的授权信息 接口进行授权内容变更比对。
POST数据示例
{ <xml> <SuiteId><![CDATA[wxfc918a2d200c9a4c]]></SuiteId> <InfoType><![CDATA[change_auth]]></InfoType> <TimeStamp>1403610513</TimeStamp> <AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId> </xml> }
应用提供商在收到推送消息后需要返回字符串success
字段说明
参数 | 说明 |
---|---|
SuiteId | 应用套件的SuiteId |
InfoType | change_auth |
TimeStamp | 时间戳 |
AuthCorpId | 授权方企业号的corpid |
为了加强安全性,postdata中的xml将使用应用套件申请时的加解密key来进行加密,具体请见“使用回调模式”,注意需要将corpid替换为suiteid,并忽略AgentID参数
取消授权的通知
当授权方(即授权企业号)在企业号管理端的授权管理中,取消了对套件方的授权托管后,微信服务器会向应用提供商的套件事件接收 URL(创建套件时填写)推送取消授权通知。
POST数据示例
{ <xml> <SuiteId><![CDATA[wxfc918a2d200c9a4c]]></ SuiteId> <InfoType><![CDATA[cancel_auth]]></InfoType> <TimeStamp>1403610513</TimeStamp> <AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId> </xml> }
应用提供商在收到推送消息后需要返回字符串success
字段说明
参数 | 说明 |
---|---|
SuiteId | 应用套件的SuiteId |
InfoType | cancel_auth |
TimeStamp | 时间戳 |
AuthCorpId | 授权方企业号的corpid |
为了加强安全性,postdata中的xml将使用应用套件申请时的加解密key来进行加密,具体请见“使用回调模式”,注意需要将corpid替换为suiteid,并忽略AgentID参数
授权成功推送auth_code事件
使用方式为‘线上自助注册授权使用’的套件,从企业号第三方官网发起授权时,微信服务器会向应用提供商的套件事件接收 URL(创建套件时填写)推送授权成功通知;从应用提供商网站发起的应用套件授权流程,由于授权完成时会跳转应用提供商管理后台,微信服务器不会向应用提供商推送授权成功通知。
POST数据示例
{ <xml> <SuiteId><![CDATA[wxfc918a2d200c9a4c]]></ SuiteId> <AuthCode><![CDATA[AUTHCODE]]></AuthCode> <InfoType><![CDATA[create_auth]]></InfoType> <TimeStamp>1403610513</TimeStamp> </xml> }
应用提供商在收到推送消息后需要返回字符串success,返回值不是 success 时,会把返回内容当作错误信息显示(需要以UTF8编码)。
字段说明
参数 | 说明 |
---|---|
SuiteId | 应用套件的SuiteId |
AuthCode | 授权的auth_code,用于获取企业的永久授权码 |
InfoType | create_auth |
TimeStamp | 时间戳 |