联盟车辆油箱、气瓶液位查询
- 接口地址:https://api.itink.com.cn/api/energy/oil-level.json
- 返回格式:json
- 请求方式:GET
- 请求示例:https://api.itink.com.cn/api/energy/oil-level.json?token=您的token&carId=车架号或车牌号&beginTime=开始时间&endTime=结束时间
-
接口描述:根据客户查询的时间段,接口返回单个车辆历史油箱液位数据(单位:%)和数据采集时间,最远可追溯近3个月内数据,单次调用最长可追溯72小时内数据。
-
请求参数说明
| 名称 | 是否必填 | 数据类型 | 说明 |
|---|---|---|---|
| token | 是 | string | 访问凭据;由联盟平台与提供 |
| carId | 是 | string | 车辆VIN或车牌号信息(输入17位车架号或者车牌信息) |
| beginTime | 是 | string | 开始时间,格式yyyy-MM-dd HH:mm:ss |
| endTime | 是 | string | 结束时间,格式yyyy-MM-dd HH:mm:ss |
- 返回参数说明
| 名称 | 数据类型 | 说明 | |
|---|---|---|---|
| code | string | 返回值:1: 成功,-1:失败 | |
| msg | string | 接口请求后的返回的中文描述 | |
| data | List | ||
| └ | levelVal | Double | 油箱液位(%) |
| └ | time | string | 数据采集时间 (YYYY-MM-DD HH:mm:ss ) |
- 返回内容示例
正常返回示例: { "data" : [ { "levelVal" : 95.6, "time" : "2024-02-16 00:00:07" }, { "levelVal" : 95.6, "time" : "2024-02-16 00:00:37" }, { "levelVal" : 95.2, "time" : "2024-02-16 00:01:07" }, { "levelVal" : 94.8, "time" : "2024-02-16 00:01:37" }, { "levelVal" : 94.8, "time" : "2024-02-16 00:02:07" }, { "levelVal" : 94.8, "time" : "2024-02-16 00:02:37" }, { "levelVal" : 94.4, "time" : "2024-02-16 00:03:07" }, { "levelVal" : 94.4, "time" : "2024-02-16 00:03:37" }, { "levelVal" : 94.4, "time" : "2024-02-16 00:04:07" }, { "levelVal" : 94.4, "time" : "2024-02-16 00:04:37" }, { "levelVal" : 94.0, "time" : "2024-02-16 00:05:07" }, { "levelVal" : 94.4, "time" : "2024-02-16 00:05:37" }, { "levelVal" : 94.4, "time" : "2024-02-16 00:06:07" }, { "levelVal" : 94.0, "time" : "2024-02-16 00:06:37" } ], "code" : 1, "msg" : "查询成功", "source" : "FOTON" }