全部产品
Search

搜索本产品

    ID Verification：ID_2META

    文档中心

    ID Verification：ID_2META

    更新时间：Sep 29, 2025

    本文介绍身份二要素核验API接口。​

    身份证二要素核验

    • 接口名：Id2MetaVerifyIntl

    • 请求方法：POST和GET

    • 传输协议：HTTPS

    • 接口说明：身份证二要素核验，输入姓名和身份证，返回是否一致。

    • QPS限量：API独享QPS限量，详情请参见ID Verification服务端API QPS限量说明。

    • 服务地址：

      说明

      内网指的是阿里云同地域产品之间的内部通信网络，如果您的业务服务器部署在阿里云的对应地域，可以通过内网域名访问 ID Verification 服务，以获得更安全、稳定的网络通信质量。

      中国香港

      • 公网：cloudauth-intl.cn-hongkong.aliyuncs.com

      • 内网：cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    在线调试和集成

    说明

    在调试和集成前，请确保您已完整阅读使用OpenAPI调试和集成服务端API文档，充分了解API接口在OpenAPI平台的调用方式和SDK及其代码的获取方式。

    您可以在OpenAPI Explorer中直接运行本接口进行调试，并生成本接口的SDK代码示例。

    请求参数​

    名称

    类型

    是否必选

    描述

    示例值

    ProductCode

    String

    是

    接入的产品方案，固定值：ID_2META

    ID_2META

    ParamType

    String

    是

    参数类型。

    normal：原始值（明文）。

    说明

    由于权威数据源限制，身份二要素核验不支持MD5加密方式。

    normal

    IdentifyNum

    String

    是

    身份证号。

    说明

    仅支持中国内地居民身份证。

    411***********0001

    UserName

    String

    是

    姓名。

    张*

    返回数据​

    名称

    类型

    描述

    示例值

    RequestId

    String

    请求ID。

    130A2C10-B9EE-4D84-88E3-5384FF039795

    Code

    String

    返回Code。

    Success

    Message

    String

    返回Code的详细描述。

    success

    Result

    Object

    无。

    无

    BizCode

    String

    核验结果：

    • 1：校验⼀致（计费）

    • 2：校验不⼀致（计费）

    • 3：查⽆记录（不计费）

    1

    返回Code

    HTTP 状态码

    Code

    描述

    200

    Success

    请求成功。

    400

    MissingParameter

    参数不能为空。

    Forbidden.ExceptionRepeatedInvoke

    异常重复调用次数超限。

    401

    InvalidParameter

    非法参数。

    403

    Forbidden.AccountAccessDenied

    确保您开通了ID verification，并且保证账户未欠费。

    Forbidden.RAMUserAccessDenied

    需要给RAM用户授予 AliyunAntCloudAuthFullAccess 的操作权限。

    500

    Forbidden.ExceptionDataSource

    权威源服务异常。

    InternalError

    系统内部错误，请反馈工程师排查。