1. 查询设备环境

获取某个时间段某个设备的环境

GET:http://api.xdua.com/gwenv
字段名 位置 类型 字段说明 举例 可选
apiv head string API版本(默认1.0.0) 1.0.0 可选
Authorization head string 鉴权token Authorization字符串 必选
filter query string 完全OTS的查询条件 仅仅支持范围查询 必选
page query int 搜索页号 page出现的时侯,忽略offset和limit一起表达第page页,有limit条记录 可选
offset query int 搜索开始的偏移条件 偏移，不设置默认为0 可选
limit query int 搜索数量 数目，不设置默认为20 可选
dataform query int 查询后的加工方式 checkmacs 可选
order query string 顺序 正序或倒序:"forward"/"backward" 可选

gwenv后台使用OTS,不支持分页,所以page,offset,limit是无意义的。

where字段构成解析

字段名 位置 类型 字段说明 举例 可选
gmac where string 设备的MAC地址 "AC233FC0422D" 必选
time0 where int 起始时间戳(UTC) 1563037033 必选
time1 where int 结束时间戳(UTC) 1563037035 必选
type where int 环境的种类 1 必选
dmac where int 设备的MAC地址 1 必选

一个典型的查询条件如下:

 {
    "where": {"gmac":"AC233FC0422D","time0":1563037033,"time1":1563037035,"type":1,"dmac":"AC233FC0422D"},
    "order":"forward",
}

一个查勤的查询条件如下

 {
    "where": {"gmac":"AC233FC0422D","time0":1563037033,"time1":1563037035,"type":1,"dmac":"AC233FC0422D"},
    "order":"forward",
    "dataform":"checkmacs"
}

浏览器调用SDK

    query = {
        "where": {"gmac":"AC233FC0422D","time0":1563036033,"time1":1564037078,"type":1},
        "limit":10,
        "dataform":"checkmacs"
    }

    const dua = await lovearth({
        APP_KEY: "EIxcPdpT",
        APP_SECRET: "b8466f37b99bea6496b192be399cfbd2",
    })
    api_name = "查询环境"
    res = await dua.qryDvenv(obj_key)
    console.log(JSON.stringify(res));
    if(res.error == 0){
        console.log(api_name+"成功");
    }else{
        console.log(api_name+"失败 "+res.reason);
    }

返回数据

默认成功成功返回数据格式

{
    "S2": {
        "silent": 0,"onc": 0,"active": 0,"offc": 2,
        "list": [
            {
                "name": "傻瓜再见","active": 0,"on": 0,"mac": "015E83991D84","avatar": "http://avatar.xdua.com/mac/015E83991D84.jpg"
            },
            {
                "name": "二比蓝牙设备","active": 0,"on": 0,"mac": "013B0AB31CAB","avatar": "http://avatar.xdua.com/mac/013B0AB31CAB.jpg"
            }
        ]
    },
    "S1": {
        "silent": 0,
        "onc": 0,
        "active": 0,
        "offc": 2,
        "list": [
            {   
                "name": "一个普通蓝牙","active": 0,"on": 0,"mac": "0026FF354CE4","avatar": "http://avatar.xdua.com/mac/0026FF354CE4.jpg"
            },
            {
                "name": "二比蓝牙设备",
                "active": 0,
                "on": 0,
                "mac": "013B0AB31CAB",
                "avatar": "http://avatar.xdua.com/mac/013B0AB31CAB.jpg"
            }
        ]
    }
}
字段名 字段类型 字段说明
onc int 这个系列的在线设备数目
offc int 这个系列的离线设备数目
active int 这个系列的活跃设备数
silent int 这个系列的沉默设备数
list list 所有的设备在线情况

1.1. list 字段解释

字段名 字段类型 字段说明
name string 蓝牙的名字
mac string 蓝牙的MAC
avatar string 蓝牙的头像
active int 0/1表示是否活跃
on int 设备是否在线 1:在线 0:不在线

失败返回

{
    "error": >0,
    "reason": "失败原因",
    "result": {"失败返回的参考数据"},
}

1.2. 返回字段的意义

字段名 字段类型 字段说明
heat json 热图需要的数据
rssv list rssi信号值时间关系
rssd list rssi信号值的标准差
rssc list rssc信号值的数字

2. heatmap各个字段的意义

字段名 字段类型 字段说明
maxx float x最大值
minx float x最小值
maxy float y最大值
heat list x,y,v的数组

"1.000,0.378,0.016" 是x,y,v三个值串了起来 失败返回

{
    "error": >0,
    "reason": "失败原因",
    "result": {"失败返回的参考数据"},
}

results matching ""

    No results matching ""