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

古城微笑少年丶 2022-04-11 07:40 297阅读 0赞

### 一.前言 ###

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

### 二.开始 ###

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

[https://qyapi.weixin.qq.com/cgi-bin/shakearound/getshakeinfo?access\_token=ACCESS\_TOKEN][https_qyapi.weixin.qq.com_cgi-bin_shakearound_getshakeinfo_access_token_ACCESS_TOKEN]

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

请求参数示例:

{ 
       "ticket":“6ab3d8465166598a5f4e8c1b44f44645”
    }

2.参数说明

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

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",
       }
    }

参数说明

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

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

[https_qyapi.weixin.qq.com_cgi-bin_shakearound_getshakeinfo_access_token_ACCESS_TOKEN]: https://qyapi.weixin.qq.com/cgi-bin/shakearound/getshakeinfo?access_token=ACCESS_TOKEN