微信【摇一摇】

申请开通功能

接口说明 申请开通摇一摇周边功能。成功提交申请请求后，工作人员会在三个工作日内完成审核。若审核不通过，可以重新提交申请请求。若是审核中，请耐心等待工作人员审核，在审核中状态不能再提交申请请求。

接口调用说明

http请求方式: POST（请使用https协议）
https://api.weixin.qq.com/shakearound/account/register?access_token=ACCESS_TOKEN
POST数据格式：json
POST数据例子：
{
  "name": "zhang_san",
  "phone_number": "13512345678",
  "email": "weixin123@qq.com",
  "industry_id": "0118",
  "qualification_cert_urls": [
  "http://shp.qpic.cn/wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0",
  "http://shp.qpic.cn/wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0"
  ],
  "apply_reason": "test"
}

 

参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
name	是	联系人姓名，不超过20汉字或40个英文字母
phone_number	是	联系人电话
email	是	联系人邮箱
industry_id	是	平台定义的行业代号，具体请查看链接行业代号
qualification_cert_urls	是	相关资质文件的图片url，图片需先上传至微信侧服务器，用“素材管理-上传图片素材”接口上传图片，返回的图片URL再配置在此处； 当不需要资质文件时，数组内可以不填写url
apply_reason	否	申请理由，不超过250汉字或500个英文字母

返回说明正常时的返回JSON数据包示例：

{
   "data": {
       
   },
   "errcode": 0,
   "errmsg": "success."
}

查询审核状态

接口说明查询已经提交的开通摇一摇周边功能申请的审核状态。在申请提交后，工作人员会在三个工作日内完成审核。

接口调用说明

http请求方式:（请使用https协议）
https://api.weixin.qq.com/shakearound/account/auditstatus?access_token=ACCESS_TOKEN

返回说明正常时的返回JSON数据包示例：

{
    "data": {
        "apply_time": 1432026025,
        "audit_comment": "test",
        "audit_status": 1,
        "audit_time": 0
    },
    "errcode": 0,
    "errmsg": "success."
}

 

参数说明

参数	说明
apply_time	提交申请的时间戳
audit_status	审核状态。0：审核未通过、1：审核中、2：审核已通过；审核会在三个工作日内完成
audit_comment	审核备注，包括审核不通过的原因
audit_time	确定审核结果的时间戳；若状态为审核中，则该时间值为0

摇一摇事件通知

接口说明

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

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

推送XML数据包示例

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

 

参数说明

参数	说明
ToUserName	开发者微信号
FromUserName	摇一摇用户（一个OpenID）
CreateTime	消息创建时间 （整型）
MsgType	消息类型，event
Event	事件类型，ShakearoundUserShake
ChosenPageId	“周边”页卡展示出来的页面ID
UUID、major、minor	UUID、major、minor
Distance	设备与用户的距离（浮点数；单位：米）；当距离较远时，iOS会直接返回-1
Rssi	接收信号的强度指示，单位是dBm；当距离较远时，iOS会直接返回0
Measurepower	信号参考值

其中，ChosenpageId、Rssi在微信6.3.8及以上版本才会返回；Measurepower仅在Android微信6.3.8及以上版本才会返回。

参考网站：https://mp.weixin.qq.com/wiki/3/c71248e1b3efb158f258a48b72e67683.html