Skip to content

根据设备IMEI查询设备OBD车况数据

接口说明

根据imei号、开始时间和结束时间,查询近6个月且时间跨度不超过31天的数据。

请求URL

本接口通用参数里面method的值为jimi.open.device.getObdDataByImei

HTTP请求方式

GET/POST

请求参数

(1)通用参数
参见: 通用参数

(2)私有参数

参数名参数类型是否必须默认值描述
app_keyString分配给应用的AppKey
access_tokenString访问令牌,表明其是一个合法第三方
imeiString设备imei号,多个中间用英文逗号隔开; 如果设备过多,建议采用POST方式(一次最多100个IMEI)
startTimeString开始时间,格式为yyyy-MM-dd HH:mm:ss
endTimeString结束时间,格式为yyyy-MM-dd HH:mm:ss
pageNoInteger1页,最小值不能小于1
pageSizeInteger10每页大小,最大值不能大于100

返回值

参数类型描述
codeInt返回码:
0: 正确返回
其它: 失败。参考错误码说明
messageString如果code不为0,会有相应的错误信息提示
resultString返回的数据
成功后返回查询结果

result参数列表:

参数类型描述
imeiString设备IMEI号
mileageString仪表盘里程
totalMileageString累计里程
gpsSpeedStringGPS速度
rotatingSpeedString发动机转速
waterTemperatureString水温
batteryVoltageString电瓶电压
fuelConsumptionString总油耗
remainingFuleString剩余油量
engineRunTimeString发动机运行时间
failureCountString故障码个数
failureStateString故障码状态
atmosphericPressureString大气压力
intakePressureString进气压力
intakeTempString进气温度
envTempString环境温度
fuelPressureString燃油压力
airFlowString空气流量
preignitionAngleString点火提前角
throttleRelativePostionString节气门相对位置
acceleratorRelativePostionString油门踏板相对位置
longTermFuelString长期燃油调整率
obdTypeStringOBD类型
engineLoadString发动机负荷
pushTimeString网关解析时间
postTimeString上报时间
fuelConsumption2String瞬时油耗
failureAfterMileageString故障后行驶里程

正确返回示例:

plaintext
{
    "code": 0,
    "message": "success",
    "result": [
        {
            "imei": "202302161050451",
            "mileage": null,
            "totalMileage": "4299.85",
            "gpsSpeed": "0",
            "rotatingSpeed": "0",
            "waterTemperature": "0",
            "batteryVoltage": "12.8",
            "fuelConsumption": "400.69",
            "remainingFule": "70.0",
            "failureAfterMileage": "0",
            "engineRunTime": "0",
            "failureCount": "0",
            "failureState": "0",
            "atmosphericPressure": "0",
            "intakePressure": "0",
            "intakeTemp": "0",
            "envTemp": "0",
            "fuelPressure": null,
            "airFlow": null,
            "preignitionAngle": "-64.0",
            "throttleRelativePostion": "0.0",
            "acceleratorRelativePostion": "0.0",
            "longTermFuel": "-100.0",
            "obdType": "41",
            "engineLoad": "0",
            "pushTime": "2026-01-12 10:26:22",
            "postTime": "2026-01-12 18:26:22",
            "fuelConsumption2": null
        }
    ],
    "data": null
}

错误返回示例:

plaintext
{"code":xxx,"message":"非法设备"}