联盟车辆能耗查询
- 接口地址:https://api.itink.com.cn/api/energy/summary.json
- 返回格式:json
- 请求方式:GET
- 请求示例:https://api.itink.com.cn/api/energy/summary.json?token=您的token&carId=车架号或车牌号&beginTime=开始时间&endTime=结束时间
-
接口描述:根据客户查询时间段,接口返回车辆的燃料类型,以及查询时间段内的单个车辆汇总行数据,包含:驶里程(单位:米)、行驶时长(单位:秒,含怠速时长)、行驶能耗(根据车辆的燃料类型,燃油车辆提供:油耗数据(单位:L),燃气车辆提供:气耗数据(单位:Kg))。数据追溯时间范围区间为1-90天,单次查询时间间隔区间最大为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 | Map | ||
| └ | mileage | Long | 行驶里程(米) |
| └ | time | Long | 行驶时长(秒)包含怠速时长 |
| └ | fuelType | Short | 燃料类型(1:油耗;2:气耗) |
| └ | energy | Double | 行驶能耗:(1位小数),油耗(升),气耗(Kg) |
- 返回内容示例
正常返回示例: { "data" : { "mileage" : 660, "time" : 7379, "fuelType" : 1, "energy" : 0.8 }, "code" : 1, "msg" : "查询成功", "source" : "FOTON" }