AI 助理
备案控制台
文档
输入文档关键字查找
首页 实人认证 信息核验 开发参考 身份核验 身份证有效期核验

身份证有效期核验

更新时间：
产品详情
我的收藏

本文介绍身份证有效期核验API接口。

接口信息

  • 接口名：Id2MetaPeriodVerify

  • 服务地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）

  • 接口说明：传入姓名、身份证号、身份证有效期开始日期和到期日期，通过权威源验证其真实性和一致性。

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

请求参数

名称

类型

是否必选

描述

示例值

ParamType

String

是

加密方式：

  • normal：明文不加密

  • md5：MD5加密

重要

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

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

normal

IdentifyNum

String

是

身份证号：

  • paramType 传 normal 时：输入身份证号码明文。

  • paramType 传 md5 时：

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

  • 明文：4290**********8211

  • 密文：4290**32fa7bcd874161bea8ec8fd98f390ec98211

UserName

String

是

姓名：

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

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

  • 明文：张三

  • 密文：6499fc7409049355527ef6a2ba5706b8三

ValidityStartDate

String

是

身份证有效期开始日期，格式：YYYYMMDD。

20201001

ValidityEndDate

String

是

身份证有效期到期日期，格式：YYYYMMDD。

20301001

响应参数

名称

类型

描述

示例值

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

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

上一篇：身份二要素核验下一篇：手机号核验
文档推荐