AI 助理
文档备案控制台
官方文档
首页

车辆要素核验

更新时间：
复制 MD 格式
产品详情
我的收藏

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

接口信息

重要

在使用本接口前，请确保已完整阅读接入流程，并开通服务。

  • 接口名：VehicleMetaVerify

  • 接口说明：核验姓名、身份证号、车牌号、车辆类型的一致性。

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

  • 服务地址（调用 API 时的 Endpoint）：

    地域

    IPv4

    IPv6

    通用

    cloudauth.aliyuncs.com

    cloudauth-dualstack.aliyuncs.com

    北京

    cloudauth.cn-beijing.aliyuncs.com

    cloudauth-dualstack.cn-beijing.aliyuncs.com

    上海

    cloudauth.cn-shanghai.aliyuncs.com

    cloudauth-dualstack.cn-shanghai.aliyuncs.com

    说明

    • 服务地址可选择与业务服务器距离相近的 endpoint ，以降低延迟。

    • 也可以构建列表轮询使用，以提高可用性。

    重要

    信息核验服务暂不支持基于调用次数的硬性封顶或自动停用功能。为有效控制成本并防范高额账单风险，建议在接入产品后及时配置消费告警规则：

    1. 配置消费预警：设置高额消费预警阈值，实时监控账单支出情况。

    2. 监控流量包余量：若已购买流量包，请同步设置资源包余量预警，以便及时补充资源或调整调用策略。

    3. 配置业务监控：参见安全管理，监控业务异动，及时识别业务请求波动。

请求参数

名称

类型

是否必选

描述

示例值

ParamType

String

是

加密方式：

  • normal：明文不加密

  • sm2：SM2加密

    重要

    SM2参数加密的相关信息，请参考参数加密说明。

normal

VerifyMetaType

String

是

核验类型：

  • VEHICLE_2_META：姓名+车牌号核验

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

VEHICLE_3_META

UserName

String

是

姓名：

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

  • paramType 传 sm2 时：传入姓名密文。

  • 明文：张三

  • 密文：

    MG8CIQCxI0wNYbc0c2BRL+7+tSethTXfQC391ZFnszRRcvRZ9AIgekQYhgDtxaDuoRD4bde/5fnFdlUp4YoxlEnIFLLm2mQEILkctuy6Rw6lfAUxBtkpPoPVCJAeD5al/RX8JFUvTACEBAYAgLJjBe0=

VehicleNum

String

是

车牌号：

  • paramType 传 normal 时：传入明文。

  • paramType 传 sm2 时：传入车牌号密文。

  • 明文：浙AF89**

  • 密文：

    MHMCIQD01OTXYNshCTNbZubTt9rTJfoL6I9HMF0j5i0g8K8tUAIhAJWSnKmNKycoqM+Rg9T10CPwc+SllE4lpcJnAH+UyxSxBCCPgmj+0sgZzsqOR67/96IuIOTNjqB7092Q+fNHycb5pQQJKExoVUT4bGpL

IdentifyNum

String

否

身份证号：

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

  • paramType 传 sm2 时：传入证件号密文。

重要

当VerifyMetaType = VEHICLE_3_META，此项必填。

  • 明文：429001********8211

  • 密文：

    MHsCIEPDt1ycBNSVgA2yKsMnvWGheiI+STWqJLmYWlZnklhnAiEAwq1bk5YVepHwqfMsd9ErlK71OrdXx8E+wfqbzyFCwoMEIM1QdrFeekvQh6fwK7sVXAsNePiNm7Eulqm/zahRosbKBBKgtyhm3SopJ3tO/wALKXQQW+g=

VehicleType

String

否

车辆类型：

  • 01：大车

  • 02：普通小客车

  • 51：新能源大车

  • 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调用示例，并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。

    说明

    注意选择所需的编程语言。

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

  • OpenAPI平台：可对接口进行在线调试，并获取SDK示例。

  • 代码示例工程：各编程语言调用SDK的示例工程，可作为接入参考。

上一篇：车辆要素核验增强版下一篇：车五项信息识别