一.前言
利用微信摇一摇的功能接口可实现我们日常的某些需求,比如微信摇一摇签到等。首先需要购买设备,然后在开发者后台创建应用以及绑定回调界面,回接下来就开始开发了。
二.开始
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",
}
}