> 微信公众号开发手册 > 摇一摇事件通知

摇一摇事件通知

摇一摇事件通知

接口说明 

用户进入摇一摇界面,在“周边”页卡下摇一摇时,微信会把这个事件推送到开发者填写的URL(登录公众平台进入开发者中心设置)。推送内容包含摇一摇时“周边”页卡展示出来的页面所对应的设备信息,以及附近最多五个属于该公众账号的设备的信息。 当摇出列表时,此事件不推送。

微信服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。关于重试的消息排重,推荐使用FromUserName + CreateTime 排重。假如服务器无法保证在五秒内处理并回复,可以直接回复空串,微信服务器不会对此作任何处理,并且不会发起重试。

推送XML数据包示例

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1433332012</CreateTime>
   <MsgType><![CDATA[event]]></MsgType>
   <Event><![CDATA[ShakearoundUserShake]]></Event>
   <ChosenBeacon>
       <Uuid><![CDATA[uuid]]></Uuid>
       <Major>major</Major>
       <Minor>minor</Minor>
       <Distance>0.057</Distance>
   </ChosenBeacon>
   <AroundBeacons>
       <AroundBeacon>
           <Uuid><![CDATA[uuid]]></Uuid>
           <Major>major</Major>
           <Minor>minor</Minor>
           <Distance>166.816</Distance>
       </AroundBeacon>
       <AroundBeacon>
           <Uuid><![CDATA[uuid]]></Uuid>
           <Major>major</Major>
           <Minor>minor</Minor>
           <Distance>15.013</Distance>
       </AroundBeacon>
   </AroundBeacons>
</xml>

参数说明

参数 说明
ToUserName 开发者微信号
FromUserName 摇一摇用户(一个OpenID)
CreateTime 消息创建时间 (整型)
MsgType 消息类型,event
Event 事件类型,ShakearoundUserShake
UUID、major、minor UUID、major、minor
Distance 设备与用户的距离(浮点数;单位:米)