车辆要素核验增强版

本文介绍车辆要素核验增强版API接口的使用方式和参数声明。

接口信息

  • 接口名:VehicleMetaVerifyV2

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

  • 接口说明:核验姓名、身份证号、车牌号、车辆类型的一致性,并支持返回车辆详情。

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

请求参数

名称

类型

是否必选

描述

示例值

ParamType

String

加密方式:

  • normal:明文不加密

  • md5:MD5加密

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

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

normal

VerifyMetaType

String

核验类型:

  • VEHICLE_2_META:姓名+车牌号核验

  • VEHICLE_3_META:姓名+车牌号+身份证号核验

VEHICLE_3_META

UserName

String

姓名:

  • paramType 传 normal 时:传入姓名明文。

  • paramType 传 md5 时:传入姓名第一个字(密文)+ 姓名其他部分(明文)。

  • 明文:张三

  • 密文:

    6499fc7409049355527ef6a2ba5706b8三

VehicleNum

String

车牌号:

  • paramType 传 normal 时:传入明文。

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

  • 明文:浙AF89**

  • 密文:

    浙AF89 6499fc7409049355527ef6a2ba5706b8

IdentifyNum

String

身份证号:

  • paramType 传 normal 时:传入证件号明文。

  • paramType 传 md5 时:

    身份证号前6位(明文)+出生年月日(密文)+身份证号后4位(明文)。

重要

VerifyMetaType = VEHICLE_3_META,此项必填。

  • 明文:429001********8211

  • 密文:

    42900132fa7bcd874161bea8ec8fd98f390ec98211

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:校验⼀致(计费)

  • 2:校验不⼀致(计费)

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

1

VehicleInfo

String

车辆详细信息。

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

重要

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

{
    "approvedCount": "5",
    "approvedLoad": "0",
    "axleCount": "2",
    "backWheelDistance": "1480",
    "brand": "宝马",
    "color": "白",
    "displacement": "1598",
    "engineNum": "JC9AQ09***",
    "engineType": "JL478QE***",
    "frontWheelDistance": "1490",
    "fuelType": "汽油",
    "inspectionDate": "2026-08-31 00:00:00",
    "modelNum": "SC7168FA***",
    "power": "92",
    "registrationDate": "2018-08-06 00:00:00",
    "releaseDate": "2018-07-10 00:00:00",
    "retirementDate": "2099-12-31 00:00:00",
    "totalMass": "1595",
    "type": "小型轿车",
    "unladenMass": "1220",
    "useProperty": "非营运",
    "vehicleState": "正常",
    "vin": "LS5A2ABE3JD013***",
    "wheelBase": "2610"
}

VehicleInfo字段详细说明

名称

说明

brand

品牌

vin

车辆识别代号

modelNum

车辆型号

engineNum

发动机号

type

车辆类型

color

车身颜色

useProperty

使用性质

registrationDate

初次登记日期

inspectionDate

检验有效期止

retirementDate

强制报废日期

vehicleState

机动车状态

engineType

发动机型号

fuelType

燃料种类

displacement

排量(ml)

power

功率(kw)

axleCount

轴数

wheelBase

轴距(mm)

frontWheelDistance

前轮距(mm)

backWheelDistance

后轮距(mm)

totalMass

总质量(kg)

unladenMass

整备质量(kg)

approvedLoad

额定载质量(kg)

approvedCount

核定载客

releaseDate

出厂日期

SDK​调用示例

重要

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

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

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

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

      image

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

      image

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