车五项信息识别

本文介绍车五项信息识别API接口的使用方式和参数声明。

接口信息

  • 接口名:Vehicle5ItemQuery

  • 服务地址:cloudauth.aliyuncs.com(IPv4)或cloudauth-dualstack.aliyuncs.com(IPv6)

  • 接口说明:通过车牌号、车辆类型,查询车辆基本信息。

  • QPS限量:API独享QPS限量,详情请参见信息核验接口QPS限量说明

请求参数

名称

类型

是否必选

描述

示例值

ParamType

String

加密方式:

  • normal:明文不加密

  • md5:MD5加密

重要
  • 所有参数的密文均取32位小写MD5字符串形式。

  • 不同MD5工具得出的密文可能不同,如果加密前接口可以调通但加密后不行,请尝试更换MD5工具。

normal

VehicleNum

String

车牌号:

  • paramType 传 normal 时:传入明文。

  • paramType 传 md5 时:传入车牌号除最后两位的其他部分(明文)+车牌最后两位(密文)。

  • 明文:浙AF89**

  • 密文:

    浙AF89 6499fc7409049355527ef6a2ba5706b8

VehicleType

String

车辆类型:

  • 02:普通小客车

  • 52:新能源小客车

02

响应结果

名称

类型

描述

示例值

RequestId

String

请求ID。

130A2C10-B9EE-4D84-88E3-5384FF03****

Message

String

返回信息。

success

Code

String

返回码:200为成功,其他为失败。

重要
  • 此参数代表是否正确调用了接口,详细的返回码说明请参见错误码

  • 业务核验结果请通过ResultObject中的字段查看。

200

ResultObject

BizCode

String

核验结果:

  • 1:查得(计费)

  • 3:查⽆记录(不计费)

1

VehicleInfo

String

车辆信息。

字段详细说明见VehicleInfo字段详细说明

重要

由于数据源原因,部分字段可能出现缺失,请做好兼容处理。

{
    "brand": "长安",
    "engineNo": "JC9AQ09*******",
    "engineType": "JL478Q****",
    "modelNo": "SC7168F***",
    "registrationDate": "2018-08-06 00:00:00",
    "state": "0",
    "stateDesc": "正常",
    "type": "小型轿车",
    "useProperty": 0,
    "usePropertyDesc": "非营运",
    "vin": "LS5A2ABE3JD013*******"
}

VehicleInfo字段详细说明

字段名称

字段说明

brand

品牌

engineNo

发动机号

engineType

发动机型号

modelNo

车辆型号

registrationDate

初次登记日期

state

机动车状态:

  • 0:正常

  • 1:转出

  • 2:被盗抢

  • 3:停驶

  • 4:注销

  • 5:违法未处理

  • 6:海关监管

  • 7:事故未处理

  • 8:嫌疑车

  • 9:查封

  • 10:暂扣

  • 11:强制注销

  • 12:事故逃逸

  • 13:锁定

  • 14:达到报废标准公告牌证作废

  • 15:逾期未审验

  • 16:逾期三个检验周期未检验

  • 17:其它

stateDesc

机动车状态中文

type

车辆类型

useProperty

使用性质:

  • 0:非营运

  • 1:公路客运

  • 2:公交客运

  • 3:出租客运

  • 4:旅游客运

  • 5:货运

  • 6:租赁

  • 7:警用

  • 8:消防

  • 9:救护

  • 10:工程救险

  • 11:营转非

  • 12:出租转非

  • 13:教练

  • 14:幼儿校车

  • 15:小学生校车

  • 16:初中生校车

  • 17:危化品运输

  • 18:中小学生校车

  • 19:其他

  • 20:预约出租转非

  • 21:预约出租客运

  • 22:营运

usePropertyDesc

使用性质中文描述

vin

车辆识别代号

SDK​调用示例

重要

集成前请确认您已获取AccessKey,并已配置环境变量。具体操作,请参见:

  • 接口在线调试和SDK示例:OpenAPI平台

    关于SDK示例和安装包获取:

    • 您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例,并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。

      image

    • 如果您有离线安装的需求,可以进入SDK安装页面选择需要语言的SDK,并转到发布地址获取。

      image

  • 各编程语言调用示例:代码示例工程