微信摇一摇之获取设备与用户信息

一.前言

利用微信摇一摇的功能接口可实现我们日常的某些需求,比如微信摇一摇签到等。首先需要购买设备，然后在开发者后台创建应用以及绑定回调界面，回接下来就开始开发了。

二.开始

1.请求说明
Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/shakearound/getshakeinfo?access_token=ACCESS_TOKEN

该接口用于获取设备信息，包括UUID、major、minor，以及距离、openID等信息。

请求参数示例:

{
   "ticket":“6ab3d8465166598a5f4e8c1b44f44645”
}

2.参数说明

参数	必须	说明
access_token	是	调用接口凭证
ticket	是	摇周边业务的ticket，可在摇到的URL中得到，ticket生效时间为30分钟，每一次摇都会重新生成新的ticket

3.权限说明
开通了摇一摇周边服务的企业号

4.返回结果
a）企业关注成员摇一摇周边时返回示例如下：

{
   "errcode": 0,
   "errmsg": "ok",
   "data": 
   {
       "page_id ": 14000,
       "beacon_info": 
       {
           "distance": 55.00620700469034,
           "major": 10001,
           "minor": 19007,
           "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
       },
      "userid": "zhangsan",
   }
}

参数说明

参数	说明
beacon_info	设备信息，包括UUID、major、minor，以及距离
UUID、major、minor	UUID、major、minor
distance	Beacon信号与手机的距离，单位为米
page_id	摇周边页面唯一ID
userid	企业号成员的userid

b）非企业关注成员摇一摇周边时返回示例如下：

{
   "errcode": 0,
   "errmsg": "ok",
   "data": 
   {
       "page_id ": 14000,
       "beacon_info": 
       {
           "distance": 55.00620700469034,
           "major": 10001,
           "minor": 19007,
           "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
       },
      "openid": "oVDmXjp7y8aG2AlBuRpMZTb1-cmA",
   }
}