查询设备列表接口可以查询已有的设备ID、UUID、Major、Minor、激活状态、备注信息、关联门店、关联页面等信息。
查询设备列表的接口如下。
https:// api.weixin.qq.com/shakearound/device/search?access_token=ACCESS_TOKEN
查询设备列表可分为以下3种情况。
1）查询指定设备时，POST数据示例如下。
{
"type":1,
"device_identifiers":[
{
"device_id":10100,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":10001,
"minor":10002
}
]
}
2）需要分页查询或者查询指定范围内的设备时，POST数据示例如下。
{
"type":2,
"last_seen":0,
"count":3
}
3）当需要根据批次ID查询时，POST数据示例如下。
{
"type":3,
"apply_id":1231,
"last_seen":10097,
"count":3
}
上述数据的参数说明如表19-1所示。
表19-1 查询设备列表接口的参数说明
正确提交时，返回的数据示例如下。
{
"data":{
"devices":[
{
"comment":"研发中心",
"device_id":5891887,
"last_active_time":0,
"major":10061,
"minor":45587,
"poi_id":461260045,
"status":0,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
},
{
"comment":"地方高校",
"device_id":6026002,
"last_active_time":0,
"major":10063,
"minor":32395,
"poi_id":272970733,
"status":0,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
},
{
"comment":"总部大厦",
"device_id":10418648,
"last_active_time":0,
"major":10091,
"minor":43416,
"poi_id":276036957,
"status":1,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
}
],
"total_count":3
},
"errcode":0,
"errmsg":"success."
}
上述数据的参数说明如表19-2所示。
表19-2 查询设备列表接口返回参数说明
