数据信息
获取设备当天上报数据
通过对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返回的为相关错误信息 |
是 |