查询设备列表接口可以查询已有的设备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 查询设备列表接口返回参数说明