数据信息

获取设备当天上报数据

通过对URL的访问获取已经开放的设备当天上报的某数据点的数据,数据为每分钟合并一条之后的数据。用户传参数subid表明获取子设备数据,不传参数subid表明获取主设备数据。

请求URL:

curl "https://HOST/open/v2/get/api"

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

返回的 JSON 数据:

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data": "[1468231034:25, 1468231027:25, 1468231020:25, 1468209778:25, 1468209716:25, 1468209655:25]"

}

请求参数:

参数名 类型 说明 备注 必需
mac String 设备的Mac 如:5c:cf:7f:c1:0b:fd或者IMEI,主设备的mac或者IMEI
subid String 子设备id 用户传参数subid表明获取子设备数据,
不传参数subid表明获取主设备数据
key String 功能点的变量名 功能点参数名
uid Int 用户id 参考相关参数章节
tt Int 时间戳 参考相关参数章节
sign String 用户签名 参考相关参数章节

返回参数:

参数名 类型 说明 备注 必需
data String 返回当天该设
备所有上报数据
数据之间通过逗号分隔,每一条数据
通过冒号分隔,冒号前面是上报的时间戳,
冒号后面是上报的具体数据,Json格式的字符串
code Int 返回码 查看Api返回码
msg String 返回信息 如果code为0,则msg为空;如果code不为0,
则msg返回的为相关错误信息

获取设备所有数据点的最新一条上报数据

通过对URL的访问获取已经开放的设备所有数据点的最新一条上报数据。用户传参数subid表明获取子设备数据,不传参数subid表明获取主设备数据。

请求URL:

curl "https://HOST/open/v2/getdp/api"

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

返回的 JSON 数据:

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data": {

"cmd": "22",

"humidity": "71",

"uv": "12",

"battery": "3",

"cho": "52",

"pm25": "67",

"sun": "30",

"rain": "49",

"temperature": "92"

}

}

请求参数:

参数名 类型 说明 备注 必需
mac String 设备的Mac 如:5c:cf:7f:c1:0b:fd或者IMEI,
主设备的mac或者IMEI
subid String 子设备id 用户传参数subid表明获取子设备设局,
不传参数subid或者为空表明获取主设备数据
uid Int 用户id 参考相关参数章节
tt Int 时间戳 参考相关参数章节
sign String 用户签名 参考相关参数章节

返回参数:

参数名 类型 说明 备注 必需
data String 返回当天该设备所有数据
点上报的最新一条数据
数据点和值是一组key-value键
值对 ,Json格式的字符串
code Int 返回码 查看Api返回码
msg String 返回信息 如果code为0,则msg为空;
如果code不为0,则msg返回的为
相关错误信息

推送消息到设备(离线不存储)

通过Http Post请求对指定设备进行消息推送。Post请求方式,参数以x-www-form-urlencoded方式放在body里。设备不在线,push的消息云端不存储,设备上线之后不能收到消息。用户传参数subid表明推送消息到子设备,不传参数subid表明推送消息到主设备。以后该接口将不再继续更新,最新接替接口为文档28接口。

请求URL:

curl "https://HOST/open/v2/push/api"

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx&data={\"alert\":\"lowbattery\"}"

返回的 JSON 数据:

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数:

参数名 类型 说明 备注 必需
mac String 设备的Mac 如: 5c:cf:7f:c1:0b:fd或者IMEI,主设备的mac或者IMEI
subid String 子设备id 用户传参数subid表明推送消息到子设备,
不传参数subid表明推送消息到主设备
uid Int 用户id 参考相关参数章节
tt Int 时间戳 参考相关参数章节
sign String 用户签名 参考相关参数章节
data json 下发的消息 消息目前支持字符串格式

返回参数:

参数名 类型 说明 备注 必需
code Int 返回码 查看Api返回码
msg String 返回信息 如果code为0,则msg为空;
如果code不为0,则msg返回的为相关错误信息

推送消息到设备(离线存储)

通过Http Post请求对指定设备进行消息推送。Post请求方式,参数以x-www-form-urlencoded方式放在body里。设备不在线,push的消息云端存储,最多存储20条数据,设备上线之后能收到离线的消息。用户传参数subid表明推送消息到子设备,不传参数subid表明推送消息到主设备。以后该接口将不再继续更新,最新接替接口为文档29接口。

请求URL:

curl "https://HOST/open/v1/push/cache/api"

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx&data={\"alert\":\"lowbattery\"}"

返回的 JSON 数据:

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数:

参数名 类型 说明 必需
mac String 设备的Mac 如: 5c:cf:7f:c1:0b:fd或者IMEI,
主设备的mac或者IMEI
subid String 子设备id 用户传参数subid表明推送消息到子设备,
不传参数subid表明推送消息到主设备
uid Int 用户id 参考相关参数章节
tt Int 时间戳 参考相关参数章节
sign String 用户签名 参考相关参数章节
data json 下发的消息 消息目前支持字符串格式

返回参数:

参数名 类型 说明 备注 必需
code Int 返回码 查看Api返回码
msg String 返回信息 如果code为0,则msg为空;
如果code不为0,则msg返回的为相关错误信息

上传设备数据

通过Http Post请求对指定设备的数据进行上传,持久化保存在青莲云。Post请求方式,参数以x-www-form-urlencoded方式放在body里。用户传参数subid表明子设备上传数据,不传参数subid表明主设备上传数据。

请求URL:

curl "https://HOST/open/v2/old/api/upload/data"

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx&data={\"heartrate\":[{\"time\":"1482142675",\"data\":\"89\"},{\"time\":"1482142685",\"data\":\"75\"}],\"bloodpressure\":[{\"time\":\"1482142675\", \"data\":\"188\"}, {\"time\":\"1482142685\", \"data\":\"218\"}]}"

返回的 JSON 数据:

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数:

参数名 类型 说明 备注 必需
mac String 设备的Mac 如: 5c:cf:7f:c1:0b:fd或者IMEI,主设备的mac或者IMEI
subid String 子设备id 用户传参数subid表明子设备上传数据,
不传参数subid表明主设备上传数据
uid Int 用户id 参考相关参数章节
tt Int 时间戳 参考相关参数章节
sign String 用户签名 参考相关参数章节
data json 上传的数据 按照上传数据的格式,首先是一个json格式,其次每一个
数据点是一个json,数据点里面是对象的json列表,最后
time是时间戳,data是具体的数据值

返回参数:

参数名 类型 说明 备注 必需
code Int 返回码 查看Api返回码
msg String 返回信息 如果code为0,则msg为空;
如果code不为0,则msg返回的为相关错误信息

下载设备数据

通过Http Post请求对指定设备的数据进行获取。Post请求方式,参数以x-www-form-urlencoded方式放在body里。用户传参数subid表明下载子设备数据,不传参数subid表明下载主设备数据。

请求URL:

curl "https://HOST/open/v1/api/download/data"

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

返回的 JSON 数据:

{

"code": 0,

"msg":"xxxxxxxxxxx",

"data":"{\"heartrate\":[\"1482142035:69\",\"1482142675:89\",\"1482142685:75\"],\"bloodpressure\":[\"1482142035:120\",\"1482142675:188\",\"1482142685:218\"]}"

}

请求参数:

参数名 类型 说明 备注 必需
mac String 设备的Mac 如: 5c:cf:7f:c1:0b:fd或者IMEI,主设备的mac或者IMEI
subid String 子设备id 用户传参数subid表明下载子设备数据,
不传参数subid表明下载主设备数据
uid Int 用户id 参考相关参数章节
tt Int 时间戳 参考相关参数章节
sign String 用户签名 参考相关参数章节
key String 数据点的变量名列表 设备所属产品的数据点属性
date String 获取某一天的数据 格式:2016-12-25

返回参数:

参数名 类型 说明 备注 必需
code Int 返回码 查看Api返回码
data String 返回当天该设
备所有上报数据
数据之间通过逗号分隔,每一条数据通过冒号分
隔,冒号前面是上报的时间戳,冒号后面是上报
的具体数据,Json格式的字符串
msg String 返回信息 如果code为0,则msg为空;
如果code不为0,则msg返回的为相关错误信息

上传设备新版本协议数据

通过Http Post请求上报设备新版本协议数据,这个接口上报实时数据,云端默认数据上报时间为接口调用时间。每一个数据点是一个json,i就是数据点的id,v就是数据点的值,t是数据点的类型。如:{"i":101,"v":"12","t":1}。Post请求方式,参数以x-www-form-urlencoded方式放在body里。用户传参数subid表明子设备上传数据,不传参数subid表明主设备上传数据。

请求URL:

curl "https://HOST/open/v2/new/api/upload/data"

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx&data=[{"i":101,"v":"12","t":1},{"i":102,"v":"abc","t":3}] "

返回的 JSON 数据:

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数:

参数名 类型 说明 备注 必需
mac String 设备的Mac或者IMEI 如: 5c:cf:7f:c1:0b:fd或者IMEI,主设备
的mac或者IMEI
subid String 子设备id 用户传参数subid表明子设备上传数据,
不传参数subid表明主设备上传数据
uid Int 用户id 参考相关参数章节
tt Int 时间戳 参考相关参数章节
sign String 用户签名 参考相关参数章节
data json 上传的数据 按照上传数据的格式,首先是一个jsoArrayn
格式,其次每一个数据点是一个json,i就是数
据点的id,v就是数据点的值,t是数据点的类
型。(需要在青莲云配置,硬件和云端使用)

返回参数:

参数名 类型 说明 备注 必需
code Int 返回码 查看Api返回码
msg String 返回信息 如果code为0,则msg为空;
如果code不为0,则msg返回的为相关错误信息

推送消息到设备(支持二进制消息)(离线不存储)

通过Http Post请求对指定设备进行消息推送。Post请求方式,参数以x-www-form-urlencoded方式放在body里。设备不在线,push的消息云端不存储,设备上线之后不能收到消息。用户传参数subid表明推送消息到子设备,不传参数subid表明推送消息到主设备。硬件端SDK版本需要 ≥ 02.06 才能收到二进制的push消息。

请求URL:

curl https://HOST/open/v3/push/api

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx&data={\"alert\": \"low battery\"}&type=x"

返回的 JSON 数据:

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数:

参数名 类型 说明 备注 必需
mac String 设备的Mac 如: 5c:cf:7f:c1:0b:fd或者IMEI,主设备的mac或者IMEI
subid String 子设备id 用户传参数subid表明推送消息到子设备,
不传参数subid表明推送消息到主设备
uid Int 用户id 参考相关参数章节
tt Int 时间戳 参考相关参数章节
sign String 用户签名 参考相关参数章节
data json 下发的消息 消息目前支持字符串格式
type Int 消息类型 1 字符串消息 2 二进制消息

返回参数:

参数名 类型 说明 备注 必需
code Int 返回码 查看Api返回码
msg String 返回信息 如果code为0,则msg为空;
如果code不为0,则msg返回的为相关错误信息

推送消息到设备(支持二进制消息)(离线存储)

通过Http Post请求对指定设备进行消息推送。Post请求方式,参数以x-www-form-urlencoded方式放在body里。设备不在线,push的消息云端存储,最多存储20条数据,设备上线之后能收到离线的消息。用户传参数subid表明推送消息到子设备,不传参数subid表明推送消息到主设备。硬件端SDK版本需要 ≥ 02.06 才能收到二进制的push消息。

请求URL:

curl https://HOST/open/v2/push/cache/api

-d "mac=5c:cf:7f:c1:0b:fd&subid=xxxxxx&uid=x&sign=xxxxxx&tt=xx&data={\"alert\": \"low battery\"}&type=x "

返回的 JSON 数据:

{

"code": 0,

"msg":"xxxxxxxxxxx"

}

请求参数:

参数名 类型 说明 备注 必需
mac String 设备的Mac 如: 5c:cf:7f:c1:0b:fd或者IMEI,主设备的mac或者IMEI
subid String 子设备id 用户传参数subid表明推送消息到子设备,
不传参数subid表明推送消息到主设备
uid Int 用户id 参考相关参数章节
tt Int 时间戳 参考相关参数章节
sign String 用户签名 参考相关参数章节
data json 下发的消息 消息目前支持字符串格式
type Int 消息类型 1 字符串消息 2 二进制消息

返回参数:

参数名 类型 说明 备注 必需
code Int 返回码 查看Api返回码
msg String 返回信息 如果code为0,则msg为空;
如果code不为0,则msg返回的为相关错误信息
Copyright & copy qinglianyun all right reserved,powered by Gitbook该文件修订时间: 2021-04-22 18:53:48

results matching ""

    No results matching ""