Skip to content

查询车辆详情

接口说明

通过车辆编号获取车辆详细信息。

请求URL

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

HTTP请求方式

GET/POST

请求参数

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

参数名参数类型是否必须默认值描述
access_tokenString访问令牌,表明其是一个合法第三方
carIdsString车辆ID,多个用逗号隔开。建议采用POST方式(一次最多100个carId)

返回值

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

result参数列表:

参数类型描述
carIdString车辆编号
bindUserAccountString绑定车辆账号
carOwnerNameString车主名称
carPlateNumberString车牌号
carOwnerPhoneString车主手机号
cardTypeString证件类型[IDCARD-身份证,PASSPORT-护照]
carOwnerIdCardString证件号码
carModelString车型
carFrameNumberString车架号
carEngineNumberString发动机号
carTypeString车辆类型[NEWCAR-新车;USEDCAR-二手车;IMPORTEDCAR-进口车]
loanMonthInteger贷款期限
loanSumDouble贷款额度
overallSumDouble总评额度
salesmanString业务员
homeAddressString家庭住址
workAddressString工作单位地址
sexInteger性别[0-女,1-男]
carColorString车辆颜色
loanDateString贷款日期,格式:yyyy-MM-dd
repaymentTypeString还款方式,[STAGES-等额本金, ONCE-先息后本]
imeisString安装设备IMEI,多个用逗号隔开
createTimeString创建时间
updateTimeString修改时间
loanExpirationDateString贷款到期日期
equtListString安装设备详情列表
carImageListArray车辆照片集合
imeiImageListArray设备照片集合
newCapitalAccountString所属资方

equtList参数列表:

参数类型描述
imeiString设备IMEI号
deviceNameString设备名称
activationTimeString激活时间
expirationString过期时间
mcTypeString设备机型
equipTypeString设备类型(WIRED:有线 WIRELESS:无线)
simString卡号
driverPhoneString电话
vehicleIconString车辆图标
mcTypeUseScopeString机型使用范围(aotomobile:汽车 electromobile:电动车 personal:个人 pet:宠物 plane:飞机 others:其他)
reMarkString备注
installTimeInteger安装时间

carImageList参数列表:

参数类型描述
pidInteger车辆id
fileUrlString车辆照片地址

imeiImageList参数列表:

参数类型描述
pidInteger车辆id
fileUrlString设备照片地址

正确返回示例:

js
{
  "code": 0,
  "message": "成功",
  "result": [{
    "carId": 5750,
    "bindUserAccount": "huangwm",
    "carOwnerName": "测试车辆3",
    "carOwnerPhone": null,
    "cardType": "IDCARD",
    "carOwnerIdCard": "12312312112321",
    "carPlateNumber": "TX12321",
    "carModel": "TW12321",
    "carEngineNumber": "qas123",
    "carFrameNumber": "qwe123",
    "carType": "NEWCAR",
    "overallSum": 18000,
    "loanMonth": "12",
    "loanSum": 15000,
    "salesman": "wwq",
    "homeAddress": "测试地址1",
    "workAddress": "测试地址2",
    "sex": 1,
    "carColor": "蓝色",
    "loanDate": "2018-08-15",
    "repaymentType": "STAGES",
    "imeis": "201803161655008,201804271524201",
    "createTime": "2018-05-23 19:03:56",
    "updateTime": "2018-05-23 19:03:56",
    "loanExpirationDate": "2018-05-22",
    "equtList": [
      {
        "imei": "201803161655008",
        "deviceName": "ET110-55008",
        "activationTime": null,
        "expiration": null,
        "mcType": "ET110",
        "sim": "",
        "driverPhone": null,
        "vehicleIcon": "automobile",
        "equipType": "WIRED",
        "mcTypeUseScope": "electromobile",
        "reMark": null,
        "installTime": "2018-05-22",
      },
      {
        "imei": "201804271524201",
        "deviceName": "ET100-24201",
        "activationTime": null,
        "expiration": null,
        "mcType": "ET100",
        "sim": "",
        "driverPhone": null,
        "vehicleIcon": "automobile",
        "equipType": "WIRED",
        "mcTypeUseScope": "electromobile",
        "reMark": null,
        "installTime": "2018-05-22",
      }
    ],
    "carImageList": [
      {
        "pid": 56784,
        "fileUrl": "http://frcfile.jimicloud.com/CONTRACTFILE_20210802142234485.jpg"
      },
      {
        "pid": 56784,
        "fileUrl": "http://frcfile.jimicloud.com/CONTRACTFILE_20210802142527395.jpg"
      }
    ],
    "imeiImageList": [
      {
        "pid": 6884847,
        "fileUrl": "http://frcfile.jimicloud.com/INSTALLIMAGE_20210802143557447.jpg"
      }
    ],
    "newCapitalAccount": "下级新资方1"
  }
  ......
  ]
}

错误返回示例:

js
{"code":xxx,"message":"非法用户"}