查詢設備列表接口可以查詢已有的設備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 查詢設備列表接口返回參數說明
