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

来自企业号开发者接口文档
跳转至: 导航搜索
通讯录变更通知
通讯录变更通知
 
第128行: 第128行:
 
| 时间戳
 
| 时间戳
 
|}
 
|}
<br/>
 
 
==='''<strong>通讯录变更通知</strong>'''===
 
<p>此通知仅对通讯录套件有效。当企业微信的成员可在客户端变更自己的个人信息后,企业微信服务器会推送通讯录变更通知。</p>
 
<p>https://127.0.0.1/suite/receive?msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359</p>
 
 
<p><strong>POST数据示例</strong></p>
 
 
{
 
<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[http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0]]></Avatar>
 
<ExtAttr>
 
<Item>
 
<Name><![CDATA[爱好]]></Name>
 
<Value><![CDATA[旅游]]></Value>
 
</Item>
 
<Item>
 
<Name><![CDATA[卡号]]></Name>
 
<Value><![CDATA[1234567234]]></Value>
 
</Item>
 
</ExtAttr>
 
</xml>
 
}
 
 
<p>应用提供商在收到通知后需要返回字符串success。</p>
 
<p><strong>字段说明</strong></p>
 
{| border="1" cellspacing="0" cellpadding="4" align="center" width="640px"
 
! style="width:240px"|参数
 
! stype="width:400px"|说明
 
|-
 
| SuiteId
 
| 拥有通讯录写权限的套件ID
 
|-
 
| AuthCorpId
 
| 授权企业的CorpID
 
|-
 
| InfoType
 
| 固定为change_contact
 
|-
 
| TimeStamp
 
| 时间戳
 
|-
 
| ChangeType
 
| 目前固定为update_user
 
|-
 
| UserID
 
| 变更信息的成员UserID
 
|-
 
| Name
 
| 成员名称,变更时推送
 
|-
 
| Mobile
 
| 手机号码,变更时推送
 
|-
 
| Gender
 
| 性别,变更时推送。1表示男性,2表示女性
 
|-
 
| Email
 
| 邮箱,变更时推送
 
|-
 
| Extattr
 
| 扩展属性,变更时推送
 
|}
 
<p>为了加强安全性,postdata中的xml将使用应用套件申请时的加解密key来进行加密,具体请见[http://qydev.weixin.qq.com/wiki/index.php?title=%E5%9B%9E%E8%B0%83%E6%A8%A1%E5%BC%8F#.E4.BD.BF.E7.94.A8.E5.9B.9E.E8.B0.83.E6.A8.A1.E5.BC.8F “使用回调模式”],注意需要将corpid替换为suiteid,并忽略AgentID参数</p>
 
 
<br/>
 
<br/>

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

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