车辆要素核验

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

接口信息

  • 接口名:VehicleMetaVerify

  • 服务地址: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

SDK​调用示例

重要

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

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

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

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

    image

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

    image