车辆投保日期查询

更新时间:
复制 MD 格式

本文介绍车辆投保日期查询API接口的使用方式和参数声明。

接口信息

重要

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

  • 接口名:VehicleInsureQuery

  • 接口说明:通过车牌号、车辆类型、车辆识别码(vin),查询车辆投保日志。

  • 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:明文不加密

  • md5:MD5加密

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

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

normal

VIN

String

车辆识别代码(VIN):

  • paramType 传 normal 时:传入明文。

  • paramType 传 md5 时:传入VIN码除后4位的其他部分(明文)+VIN码后4位(密文)。

  • 明文:JHJ1234567890****

  • 密文:

    JHJ123456789042900132fa7bcd874161bea8ec8fd98f390ec98211

VehicleType

String

车辆类型:

  • 01:大车

  • 02:普通小客车

  • 51:新能源大车

  • 52:新能源小客车

02

VehicleNum

String

车牌号:

  • paramType 传 normal 时:传入明文。

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

  • 明文:浙AF89**

  • 密文:

    AF89 6499fc7409049355527ef6a2ba5706b8

响应结果

名称

类型

描述

示例值

RequestId

String

请求ID。

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

Message

String

返回信息。

success

Code

String

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

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

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

200

ResultObject

BizCode

String

核验结果:

  • 1:查得(计费)

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

1

VehicleInfo

String

投保日期信息:

  • lastInsuranceDate:上次投保年月

  • firstInsuranceDate:初次投保日期

  • latestInsuranceDate:最近投保期止

  • latestInsuranceDateStart:最近投保期始

重要

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

{
    "firstInsuranceDate": "2018-08-10",
    "lastInsuranceDate": "2024-08",
    "latestInsuranceDate": "2025-08-10",
    "latestInsuranceDateStart": "2024-08-10"
}

SDK​调用示例

重要

集成前请确保您已完整阅读接入流程开通了服务获取AccessKey且正确配置环境变量

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

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

    说明

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

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

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

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