查询设备列表

接口说明 

查询已有的设备ID、UUID、Major、Minor、激活状态、备注信息、关联门店、关联页面等信息。可指定设备ID或完整的UUID、Major、Minor查询,也可批量拉取设备信息列表。查询所返回的设备列表按设备ID正序排序。

接口调用说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/device/search?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
查询指定设备时:
{
    "type": 1,
    "device_identifiers":[
  {
"device_id":10100,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":10001,
"minor":10002
}
]
}

需要分页查询或者指定范围内的设备时:
{
    "type": 2,
    "last_seen": 10097,
    "count": 3
}

当需要根据批次ID查询时:
{
    "type": 3,
    "apply_id": 1231,
    "last_seen": 10097,
    "count": 3
}

参数说明

参数是否必须说明
access_token调用接口凭证
type查询类型。1:查询设备id列表中的设备;2:分页查询所有设备信息;3:分页查询某次申请的所有设备信息
device_identifiers指定的设备 ; 当type为1时,此项为必填
device_id设备编号,若填了UUID、major、minor,则可不填设备编号,若二者都填,则以设备编号为优先;查询指定设备时,单次查询的设备数量不能超过50个
UUID、major、minorUUID、major、minor,三个信息需填写完整,若填了设备编号,则可不填此信息;查询指定设备时,单次查询的设备数量不能超过50个
apply_id批次ID,申请设备ID时所返回的批次ID;当type为3时,此项为必填
last_seen前一次查询列表末尾的设备ID , 第一次查询last_seen 为0
count待查询的设备数量,不能超过50个

返回说明 

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

{
    "data": {
        "devices": [
            {
                "comment": "",
                "device_id": 10097,
                "major": 10001,
                "minor": 12102,
                "status": 1,
                "last_active_time":1437276018,
                "poi_id": 0,
                "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
            },
            {
                "comment": "",
                "device_id": 10098,
                "major": 10001,
                "minor": 12103,
                "status": 1,
                "last_active_time":1437276018,
                "poi_appid":"wxe3813f5d8c546fc7"
                "poi_id": 123,
                "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
            } 
        ],
        "total_count": 151
    },
    "errcode": 0,
    "errmsg": "success."
}

参数说明

参数说明
devices指定的设备信息列表
device_id设备编号
UUID、major、minorUUID、major、minor
status激活状态,0:未激活,1:已激活
last_active_time设备最近一次被摇到的日期(最早只能获取前一天的数据);新申请的设备该字段值为0
poi_appid若配置了设备与其他公众账号门店关联关系,则返回配置门店归属的公众账号appid。查看配置设备与其他公众账号门店关联关系接口
poi_id设备关联的门店ID,关联门店后,在门店1KM的范围内有优先摇出信息的机会。门店相关信息具体可查看门店相关的接口文档
comment设备的备注信息
total_count商户名下的设备总量