接口说明
查询已有的设备ID、UUID、Major、Minor、激活状态、备注信息、关联门店、关联页面等信息。可指定设备ID或完整的UUID、Major、Minor查询，也可批量拉取设备信息列表。查询所返回的设备列表按设备ID正序排序。
接口调用说明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/device/search?access_token=ACCESS_TOKENPOST
数据格式：jsonPOST数据例子：查询指定设备时：
{
"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、minor | 是 | UUID、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、minor | UUID、major、minor |
| status | 激活状态，0：未激活，1：已激活 |
| last_active_time | 设备最近一次被摇到的日期（最早只能获取前一天的数据）；新申请的设备该字段值为0 |
| poi_appid | 若配置了设备与其他公众账号门店关联关系，则返回配置门店归属的公众账号appid。 查看 配置设备与其他公众账号门店关联关系接口 |
| poi_id | 设备关联的门店ID，关联门店后，在门店1KM的范围内有优先摇出信息的机会。门店相关信息具体可 查看门店相关的接口文档 |
| comment | 设备的备注信息 |
| total_count | 商户名下的设备总量 |