获取历史数据接口
通过该接口批量获取设备上传的历史数据
请求协议:HTTP
请求类型:POST
请求地址:http://service.easylinkin.com/api/deviceFlow/v1/list
请求Headers:
| Key | Value | 字段说明 |
|---|---|---|
| Content-Type | application/json | POST请求方式 |
| api-key | - | 每个账户会自动生成32字符的api密钥,如:da9cce31291348e3b3e6ff21b3d69329 |
| Nonce | - | 8字符的随机数,每字符为0~9,如:00123456 |
| Timestamp | - | 毫秒格式的当前时间戳,(自1970-01-01 00:00:00开始的毫秒数);LinkOS会拒绝超过3分钟之前生成的请求,如1573716339046 |
| Signature | - | 每个账户会自动生成32字符的api-secret,如:cd1f59df0aa74a28b4f9397926efd6,以”[Nonce][Timestamp][api-secret]”形式拼接字符串,并计算SHA1值,作为Signature值,如:“001234561573716339046cd1f59df0aa74a28b4f9397926efd6”计算结果为:28a5160557069d23eb8c10a531599ad60e4030d8,以小写形式填写 |
请求参数:JSON形式
| 参数名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| device_id | string | 是 | 设备ID |
| start_time | number | 否 | 开始时间,时间戳形式,精确到毫秒 |
| end_time | number | 否 | 截止时间,时间戳形式,精确到毫秒 |
| pageable | object | 否 | 为空时默认查询前100条,单页显示 |
pageable字段的结构如下:
| 参数名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| page | number | 是 | 查询的第几页 |
| size | number | 是 | 每页的大小 |
响应
| 参数名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| msg | string | 是 | 响应消息 |
| code | string | 是 | 响应码 |
| success | bool | 是 | 查询是否成功 |
| data | object | 否 | 是否分页查询,为空时默认查询前100条,单页显示 |
data字段的结构如下:
| 参数名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| content | object数组 | 是 | 设备历史数据 |
| totalElements | number | 是 | 数据总数 |
| totalPages | number | 是 | 总页数 |
| size | number | 是 | 每页大小 |
| number | number | 是 | 当前页需要,从第0页开始 |
| numberOfElements | number | 是 | 当前页数据数量 |
| first | bool | 是 | 是否为第一页 |
| last | bool | 是 | 是否为最后一页 |
content字段的结构如下:
| 参数名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| createTime | string | 是 | 数据创建时间 |
| data | string | 是 | 设备上报数据,具体格式依赖于设备格式定义 |