设备信息

下发命令控制设备

通过对URL的访问来对已经开放的设备进行控制，比如下发命令控制设备，或者设置设备配置等。用户传参数subid表明对子设备控制，不传参数subid表明对主设备控制。支持下发二进制命令。

请求URL：

cur "https://HOST/open/v3/set/api"

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx&key=xxx&value=xxx"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数：

返回参数：

查询设备是否在线

通过Http Post请求查询指定设备是否在线。Post请求方式，参数以x-www-form-urlencoded方式放在body里。用户传参数subid表明查询子设备在线状态，不传参数subid表明查询主设备在线状态。

请求URL：

curl "https://HOST/open/v1/api/mac/online"

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data": "true"

}

请求参数：

返回参数：

查询设备是否OTA升级

通过Http Post请求查询指定设备是否需要ota升级。Post请求方式，参数以x-www-form-urlencoded方式放在body里。该版本不支持子设备。

请求URL：

curl "https://HOST/open/api/check/otaupdate"

-d "mac=xx:xx:xx:xx:xx:xx&uid=x&sign=xxxxxx&tt=xx"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data": "{\"description\":\"xxxxxx\",\"mcuVersion\":\"1.0.0\"}"

}

请求参数：

返回参数：

设备初始化

通过Http Post请求对指定设备进行初始化注册。Post请求方式，参数以x-www-form-urlencoded方式放在body里。用户传参数subid表明对子设备初始化，不传参数subid表明对主设备初始化。20190425新增逻辑，设备初始化的时候需要检查设备ota升级的情况，如果有升级就去数据库修改升级状态。

请求URL：

curl "https://HOST/open/v1/api/initdevice"

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx&productId=xxxxxx& otaOwner=xxxxx&otaVersion=xxxxx"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数：

返回参数：

批量下发命令控制设备

通过Http Post请求对批量设备进行控制。Post请求方式，参数以x-www-form-urlencoded方式放在body里。可以对同一个设备下发不同的命令也可以对不同的设备批量下发命令。每次只下发data数组里一条指令，轮询发送。设备一次只能接收一条指令。最多20组指令限制。该版本不支持子设备。

请求URL：

curl "https://HOST/open/batch/set/api"

-d "uid=x&sign=xxxxxx&tt=xx&data=[{\"mac\":\"xxx\",\"key\":\"xxx\",\"value\":\"xxx\"},{\"mac\":\"xxx\",\"key\":\"xxx\",\"value\":\"xxx\"}]"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数：

返回参数：

获取设备列表

通过对URL的访问实现获取用户的设备列表包括被分享的设备。该版本支持子设备，返回列表增加子设备相关数据。

请求URL：

curl "https://HOST/open/v2/device/listinfo"

-d "uid=x&sign=xxxxxx&tt=xx&userId=xxx&userToken=xxx"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data": "{\"listinfo\":[

{\"flag\":xxx,\"deviceMac\":\"xxx\",\"displayName\":\"xxx\",\"iotId\":\"xxx\",\"iotToken\":\"xxx\",\"location\":\"xxx\",\"isOnline\":xxx,\"productId\":xxx,\"shared\":\"xxx\",\"fUserId\":x,\"moduleVersion\":\"xxx\",\"gid\":x,\"groupName\":\"xxx\",\"subsetId\":\"xxx\",\"subsetType\":\"xxx\",\"subsetName\":\"xxx\",\"subsetTradeName\":\"xxx\",\"rId\":x,\"roomName\":\"xxx\",\"thirdId\":\"xxx\",\"thirdType\":x,\"thirdTradeName\":\"xxx\",\"subIotId\":\"xxx\",\"imgUrl\":\"xxx\" },

{\"flag\":xxx,\"deviceMac\":\"xxx\",\"displayName\":\"xxx\",\"iotId\":\"xxx\",\"iotToken\":\"xxx\",\"location\":\"xxx\",\"isOnline\":xxx,\"productId\":xxx,\"shared\":\"xxx\",\"fUserId\":x,\"moduleVersion\":\"xxx\",\"gid\":x,\"groupName\":\"xxx\",\"subsetId\":\"xxx\",\"subsetType\":\"xxx\",\"subsetName\":\"xxx\",\"subsetTradeName\":\"xxx\",\"rId\":x,\"roomName\":\"xxx\",\"thirdId\":\"xxx\",\"thirdType\":x,\"thirdTradeName\":\"xxx\",\"subIotId\":\"xxx\",\"imgUrl\":\"xxx\" }

]}"

}

请求参数：

返回参数：

获取单个设备详细信息

通过对URL的访问实现获取用户单个设备的详细信息。目前获取设备详情只针对主设备，子设备没有相关信息。

请求URL：

curl "https://HOST/open/v2/device/singleinfo"

-d "uid=x&sign=xxxxxx&tt=xx&userId=xxx&userToken=xxx&mac=5c:cf:7f:c1:0b:fd"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data": "{\"singleinfo\":

{\"dataPointNum\":xxx,\"deviceIp\":\"xxx\",\"deviceMac\":\"xxx\",\"deviceType\":\"xxx\",\"displayName\":\"xxx\",\"iotId\":\"xxx\",\"ipLocation\":xxx,\"isLinkage\":xxx,\"isOnline\":xxx,\"wifiType\":x}

}"

}

请求参数：

返回参数：

查询设备的产品id

通过Http Post请求查询指定设备产品id。Post请求方式，参数以x-www-form-urlencoded方式放在body里。查询设备的产品id只针对主设备而言，子设备是跟随主设备的产品。

请求URL：

curl "https://HOST/open/api/mac/product"

-d "mac=xx:xx:xx:xx:xx:xx&uid=x&sign=xxxxxx&tt=xx"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data": "xxxxxx"

}

请求参数：

返回参数：

查询产品的授权设备数量

通过Http Post请求查询该公司旗下的产品授权设备数量以及该公司剩余授权数。Post请求方式，参数以x-www-form-urlencoded方式放在body里。

请求URL：

curl "https://HOST/open/license/query"

-d "uid=x&sign=xxxxxx&tt=xx"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data": "{\"total\":1000,

​ \"granted\":700,

​ \"remain\":200,

​ \"product\":[{\"productId\":xxx,\"deviceCnt\":xxx,\"productName\":\"xxx\"},

{\"productId\":xxx,\"deviceCnt\":xxx,\"productName\":\"xxx\"}]

}"

}

请求参数：

返回参数：

同一设备批量下发命令

通过对URL的访问来对已经开放的设备进行控制，比如下发命令控制设备，或者设置设备配置等。对同一个设备下发不同的命令，每次下发data数组里全部指令。和13接口有区别，设备端一次性接收多条指令而不是一条一条接收。下发指令最多20条限制。用户传参数subid表明对子设备控制，不传参数subid表明对主设备控制。

请求URL：

curl "https://HOST/open/v2/all/set/api"

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx&data=[{\"key\":\"xxx\",\"value\":\"xxx\"},{\"key\":\"xxx\",\"value\":\"xxx\"}]"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数：

返回参数：

获取设备在线时间

通过Http Post请求对指定设备的数据进行获取。Post请求方式，参数以x-www-form-urlencoded方式放在body里。查询主设备指定某一天的上下线行为，从而计算出设备在线时长。

请求URL：

curl "https://HOST/open/v2/get/device/online/time"

-d "mac=5c:cf:7f:c1:0b:fd&date=2019-06-28&uid=x&sign=xxxxxx&tt=xx"

返回的 JSON 数据：

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data":"{\"data\":[{\"event\":0,\"tt\":\"2019-06-27 00:03:08\"},{\"event\":1,\"tt\":\"2019-06-27 00:06:08\"},{\"event\":0,\"tt\":\"2019-06-27 00:06:37\"},{\"event\":1,\"tt\":\"2019-06-27 00:09:30\"},{\"event\":0,\"tt\":\"2019-06-27 00:10:04\"},{\"event\":1,\"tt\":\"2019-06-27 00:13:05\"}],\"mac\":\"10:10:10:10:10:28\"}"

}

请求参数：

返回参数：