第三方回调协议

来自企业号开发者接口文档
跳转至: 导航搜索

推送suite_ticket协议

微信服务器会向套件的“系统事件接收URL”定时(每十分钟)推送ticket:

https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

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(创建套件时填写)推送变更授权通知。

开发者接收到变更通知之后,需自行调用 获取企业号的授权信息 接口进行授权内容变更比对。

https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

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(创建套件时填写)推送取消授权通知。

https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

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(创建套件时填写)推送授权成功通知;从应用提供商网站发起的应用套件授权流程,由于授权完成时会跳转应用提供商管理后台,微信服务器不会向应用提供商推送授权成功通知。

https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359

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 时间戳