Skip to content

里程报表

接口说明

里程报表查询

请求URL

本接口通用参数里面method的值为jimi.mileage.list

HTTP请求方式

GET

请求参数

(1)通用参数
参见: 通用参数
(2)私有参数

参数名参数类型是否必须默认值描述
access_tokenString访问令牌,表明其是一个合法第三方
app_keyString分配给应用的AppKey
imeisString设备imei号,多个中间用英文逗号隔开
startTimeString开始时间格式:yyyy-MM-ddHH:mm:ss
endTimeString开始时间格式:yyyy-MM-ddHH:mm:ss
pageNoString1页码
pageSizeString10每页多少条
typeStringsegment统计方式(里程:segment,天:day)
methodStringjimi.mileage.list

返回值

参数类型描述
codeInt返回码:
0: 正确返回
-1请求失败
messageString如果code不为0,会有相应的错误信息提示
dataObject返回的数据
成功后返回查询结果

result参数列表:

参数类型描述
mileageReportsList(MgReport)里程信息列表
dataTotalRowsString里程信息列表条数
distanceSumString总里程(单位:km)

MgReport参数列表:

参数类型描述
accountString所属账号
userNameString客户名称
deviceNameString设备名称
imeiStringimei
mcTypeString型号
orgNameString设备分组
salesManString业务员
distanceString总里程(KM)
driverNameString司机名称
driverPhoneString司机电话
vehicleNumberString车牌号
idCardString身份证号
carFrameString车架号
engineNumberString电动机/发动机号
atDayString日期(格式:yyyy-MM-dd HH:mm:ss)segment为天时不为空
startTimeString开始时间(格式:yyyy-MM-dd HH:mm:ss)segment为里程时不为空
endTimeString结束时间(格式:yyyy-MM-dd HH:mm:ss)segment为里程时不为空

正确返回示例:

js
{
  "code": 0,
  "message": "success",
  "result": {
    "mileageReports": [
      {
        "account": "jimitest",
        "userName": "jimitest测试环境",
        "deviceName": "tag-dg-01216",
        "imei": "780906016801216",
        "mcType": "tag-dg",
        "orgName": "默认组",
        "salesMan": null,
        "distance": "1015.59",
        "driverName": null,
        "driverPhone": null,
        "vehicleNumber": null,
        "idCard": null,
        "carFrame": null,
        "engineNumber": null,
        "atDay": null,
        "startTime": "2024-12-16 15:11:16",
        "endTime": "2024-12-18 17:39:47"
      }
    ],
    "distanceSum": "1015.59",
    "dataTotalRows": "1"
  },
  "data": null
}

错误返回示例:

js
{"code":xxx,"message":"失败"}