全部产品
Search

搜索本产品

    ID Verification：MOBILE_3META

    文档中心

    ID Verification：MOBILE_3META

    更新时间：Sep 29, 2025

    本文介绍手机号三要素详版API接口。

    接口说明

    • 接口名：Mobile3MetaVerifyIntl

    • 请求方法：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

    是

    要接入的产品方案，固定值：MOBILE_3META 。

    MOBILE_3META

    ParamType

    String

    是

    参数类型：

    • normal：不加密

    • md5：md5加密

    normal

    IdentifyNum

    String

    是

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

    说明

    • 当paramType取值normal时，输入明文。

    • 当paramType取值md5时，输入32位小写md5字符串。

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

    UserName

    String

    是

    姓名。

    说明

    • 当paramType取值normal时，输入明文。

    • 当paramType取值md5时，输入32位小写md5字符串。

    张*

    Mobile

    String

    是

    手机号。

    说明

    • 当paramType取值normal时，输入明文。

    • 当paramType取值md5时，输入32位小写md5字符串。

    131****8888

    返回数据

    名称

    类型

    描述

    示例值

    RequestId

    String

    请求ID。

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

    Code

    String

    返回码。

    Success

    Message

    String

    返回Code的详细描述。

    success

    ​Result

    BizCode

    String

    核验结果：

    • 1：校验⼀致（计费）

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

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

    1

    SubCode

    String

    核验详细结果：

    • 101：验证通过。

    • 201：⼿机号和姓名不⼀致，⼿机号和证件号不⼀致。

    • 202：⼿机号和姓名⼀致，⼿机号和证件号不⼀致。

    • 203：⼿机号和证件号⼀致，⼿机号和姓名不⼀致。

    • 204：其他不⼀致。

    • 301：查⽆记录。

    101

    IspName

    String

    运营商名称：

    • CMCC：移动

    • CUCC：联通

    • CTCC：电信

    CMCC

    返回Code

    HTTP状态码

    Code

    描述

    200

    Success

    请求成功。

    400

    MissingParameter

    参数不能为空。

    Forbidden.ExceptionRepeatedInvoke

    异常重复调用次数超限。

    401

    InvalidParameter

    非法参数。

    403

    Forbidden.AccountAccessDenied

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

    Forbidden.RAMUserAccessDenied

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

    500

    Forbidden.ExceptionDataSource

    权威源服务异常。

    InternalError

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