微信小店
微信门店
微信智能接口
微信设备功能

获取设备及用户信息

出自微信公众平台开发者文档
跳转到: 导航, 搜索

获取摇周边的设备及用户信息

获取设备信息,包括UUID、major、minor,以及距离、openID等信息。

接口调用请求说明

http请求方式: POST(请使用https协议)
https://api.weixin.qq.com/shakearound/user/getshakeinfo?access_token=ACCESS_TOKEN
POST数据格式:json
POST数据例子:
{
    "ticket":”6ab3d8465166598a5f4e8c1b44f44645”,
    "need_poi":1
}

参数说明

参数 是否必须 说明
access_token 调用接口凭证
ticket 摇周边业务的ticket,可在摇到的URL中得到,ticket生效时间为30分钟,每一次摇都会重新生成新的ticket
need_poi 是否需要返回门店poi_id,传1则返回,否则不返回;门店相关信息具体可查看门店相关的接口文档

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

{
    "data": {
        "page_id ": 14211,
        "beacon_info": {
            "distance": 55.00620700469034,
            "major": 10001,
            "minor": 19007,
            "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
            "rssi": -70,
            "measure_power": -59
        },
        "openid": "oVDmXjp7y8aG2AlBuRpMZTb1-cmA",
        " poi_id":1234
    },
    "errcode": 0,
    "errmsg": "success."
}

参数说明

参数 说明
beacon_info 设备信息,包括UUID、major、minor,以及距离
UUID、major、minor UUID、major、minor
distance 设备与用户的距离(浮点数;单位:米);当距离较远时,iOS会直接返回-1
page_id 摇周边页面唯一ID
openid 商户AppID下用户的唯一标识
poi_id 门店ID,有的话则返回,反之不会在JSON格式内
rssi 接收信号的强度指示,单位是dBm;当距离较远时,iOS会直接返回0
measure_power 信号参考值

其中,rssi在微信6.3.8及以上版本才会返回;measure_power仅在Android 微信6.3.8及以上版本才会返回。