全部产品
Search

搜索本产品

    ID Verification：ID_2META

    文档中心

    ID Verification：ID_2META

    更新时间：Oct 23, 2026

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

    身份证二要素核验

    • 接口名：Id2MetaVerifyIntl

    • 请求方法：POST和GET

    • 传输协议：HTTPS

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

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

    • 服务地址：

      说明

      • 内网访问优势：内网指阿里云同一地域内各产品间的私有通信网络。若您的业务服务器部署于阿里云对应地域，请使用内网域名访问 ID Verification 服务，以获得更安全、稳定的通信质量。 

      • 海外访问优化建议：海外网络环境复杂，建议参考服务端网络耗时优化，优化集成方案，降低网络延迟及请求失败概率。

      中国香港

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

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

    在线调试和集成

    说明

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

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

    请求参数​

    名称

    类型

    是否必选

    描述

    示例值

    ProductCode

    String

    是

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

    ID_2META

    ParamType

    String

    是

    参数类型。

    • normal：原始值（明文）。

    • sm2：SM2加密密文。

    说明

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

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

    normal

    IdentifyNum

    String

    是

    身份证号。

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

    • paramType 传入 sm2 时：输入身份证号SM2密文。

    说明

    受权威源影响，仅支持二代居民身份证的证件号码。

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

    • SM2密文：MHsCIEPDt1ycBNSVgA2yKsMnvWGheiI+STWqJLmYWlZnklhnAiEAwq1bk5YVepHwqfMsd9ErlK71OrdXx8E+wfqbzyFCwoMEIM1QdrFeekvQh6fwK7sVXAsNePiNm7Eulqm/zahRosbKBBKgtyhm3SopJ3tO/wALKXQQW+g=

    UserName

    String

    是

    姓名。

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

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

    • 明文：张三

    • SM2密文：MG8CIQCxI0wNYbc0c2BRL+7+tSethTXfQC391ZFnszRRcvRZ9AIgekQYhgDtxaDuoRD4bde/5fnFdlUp4YoxlEnIFLLm2mQEILkctuy6Rw6lfAUxBtkpPoPVCJAeD5al/RX8JFUvTACEBAYAgLJjBe0=

    返回数据​

    名称

    类型

    描述

    示例值

    RequestId

    String

    请求ID。

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

    Code

    String

    返回Code，具体信息请参见服务端返回HTTP状态码说明。

    Success

    Message

    String

    返回Code的详细描述。

    success

    Result

    Object

    无。

    无

    BizCode

    String

    核验结果：

    • 1：校验⼀致（计费）

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

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

    1