个人运营商2要素信息比对

更新时间:2025-09-15 16:13:16

接口描述

提供个人姓名与手机号码在运营商系统中的一致性校验服务,验证该手机号码是否由当前姓名在运营商处办理开通。

接口

/v2/identity/verify/individual/telecom2Factors

请求方式

POST

请求头

提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。

请求参数

建议开发者传入参数时增加首尾空格校验

参数名称

类型

必选

参数类型

参数说明

name

string

body

姓名

mobileNo

string

body

手机号(中国大陆3大运营商)

响应参数

展开全部参数参数名称

类型

必选

参数说明

code

int

接口响应结果码(0代表信息一致,非0请参考下方错误码描述)

message

string

接口响应结果描述

请根据 code 来判断错误情况,不应该依赖message匹配,因为 message 可能会调整。

data

object

接口响应结果数据

verifyId

string

信息比对业务Id(e签宝数据库标识,开发者可保存,无后续接口使用)

请求示例  

{
    "name":"张三",
    "mobileNo":"18866668888"
}

响应示例

信息一致,比对通过:

{
    "code": 0,
    "message": "成功",
    "data": {
        "verifyId": "536ab48c-e374-4b3a-ac62-fbe4791cce1a"
    }
}

信息不一致,比对不通过:

{
  "code": 30504001,
  "message": "信息比对不通过,请检查信息的正确性",
  "data": {
    "verifyId": "6863e624-4cfe-438c-921c-61fa5901f245"
  }
}

错误码

错误码

错误描述

解决方案

30500100

缺少参数:姓名不能为空

请核实姓名是否为空

30500100

缺少参数:手机号不能为空

请核实手机号是否为空

30500101

参数错误:姓名只支持中文/点符号·

请输入用户真实姓名,不要包含任何英文字母、数字、空格或特殊符号

30500101

参数错误:请输入正确的手机号码

请输入真实有效的手机号

30504002

数据源查询失败,请联系服务人员处理,ID:10110******

请检查请求参数是否符合基础格式,不要包含任何英文字母、数字、空格或特殊符号;请确保提供的姓名、手机号均为真实有效信息。

30504001

信息比对不通过,请检查信息的正确性

信息比对不通过,请核实姓名、手机号是否匹配


我要纠错