设备类型-查询设备列表


上一篇 : 设备管理-配置设备与其他公众账号门店的关联关系 下一篇: 页面管理-页面管理



接口说明

查询已有的设备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 商户名下的设备总量


上一篇 : 设备管理-配置设备与其他公众账号门店的关联关系 下一篇: 页面管理-页面管理