“第三方回调协议”版本间的差异

来自企业号开发者接口文档
跳转至: 导航搜索
通讯录变更通知
通讯录变更通知
第135行: 第135行:
  
 
<p><strong>POST数据示例</strong></p>
 
<p><strong>POST数据示例</strong></p>
{
+
 
<xml>
+
{
<SuiteId><![CDATA[wxfc918a2d200c9a4c]]></SuiteId>
+
<xml>
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
+
<SuiteId><![CDATA[wxfc918a2d200c9a4c]]></SuiteId>
<InfoType><![CDATA[change_contact]]></InfoType>
+
<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
<TimeStamp>1403610513</TimeStamp>
+
<InfoType><![CDATA[change_contact]]></InfoType>
<ChangeType>update_user</ChangeType>
+
<TimeStamp>1403610513</TimeStamp>
<UserID><![CDATA[zhangsan]]></UserID>
+
<ChangeType>update_user</ChangeType>
<Name><![CDATA[张三]]></Name>
+
<UserID><![CDATA[zhangsan]]></UserID>
<Mobile>15913215421</Mobile>
+
<Name><![CDATA[张三]]></Name>
<Gender>1</Gender>
+
<Mobile>15913215421</Mobile>
<Email><![CDATA[zhangsan@gzdev.com]]></Email>
+
<Gender>1</Gender>
<Avatar><![CDATA[http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0]]></Avatar>
+
<Email><![CDATA[zhangsan@gzdev.com]]></Email>
<ExtAttr>
+
<Avatar><![CDATA[http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0]]></Avatar>
<Item>
+
<ExtAttr>
<Name><![CDATA[爱好]]></Name>
+
<Item>
<Value><![CDATA[旅游]]></Value>
+
<Name><![CDATA[爱好]]></Name>
</Item>
+
<Value><![CDATA[旅游]]></Value>
<Item>
+
</Item>
<Name><![CDATA[卡号]]></Name>
+
<Item>
<Value><![CDATA[1234567234]]></Value>
+
<Name><![CDATA[卡号]]></Name>
</Item>
+
<Value><![CDATA[1234567234]]></Value>
</ExtAttr>
+
</Item>
</xml>
+
</ExtAttr>
}
+
</xml>
 +
}
  
 
<p>应用提供商在收到通知后需要返回字符串success。</p>
 
<p>应用提供商在收到通知后需要返回字符串success。</p>

2017年4月21日 (五) 08:21的版本

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


通讯录变更通知

此通知仅对通讯录套件有效。当企业微信的成员可在客户端变更自己的个人信息后,企业微信服务器会推送通讯录变更通知。

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

POST数据示例

{
	<xml>
		<SuiteId><![CDATA[wxfc918a2d200c9a4c]]></SuiteId>
		<AuthCorpId><![CDATA[wxf8b4f85f3a794e77]]></AuthCorpId>
		<InfoType><![CDATA[change_contact]]></InfoType>
		<TimeStamp>1403610513</TimeStamp>
		<ChangeType>update_user</ChangeType>
		<UserID><![CDATA[zhangsan]]></UserID>
		<Name><![CDATA[张三]]></Name>
		<Mobile>15913215421</Mobile>
		<Gender>1</Gender>
		<Email><![CDATA[zhangsan@gzdev.com]]></Email>
		<Avatar><![CDATA[1]]></Avatar>
		<ExtAttr>
			<Item>
				<Name><![CDATA[爱好]]></Name>
				<Value><![CDATA[旅游]]></Value>
				</Item>
				<Item>
				<Name><![CDATA[卡号]]></Name>
				<Value><![CDATA[1234567234]]></Value>
			</Item>
		</ExtAttr>
	</xml>
}

应用提供商在收到通知后需要返回字符串success。

字段说明

参数 说明
SuiteId 拥有通讯录写权限的套件ID
AuthCorpId 授权企业的CorpID
InfoType 固定为change_contact
TimeStamp 时间戳
ChangeType 目前固定为update_user
UserID 变更信息的成员UserID
Name 成员名称,变更时推送
Mobile 手机号码,变更时推送
Gender 性别,变更时推送。1表示男性,2表示女性
Email 邮箱,变更时推送
Extattr 扩展属性,变更时推送

为了加强安全性,postdata中的xml将使用应用套件申请时的加解密key来进行加密,具体请见“使用回调模式”,注意需要将corpid替换为suiteid,并忽略AgentID参数