运营商3要素认证-详版

接口说明

[!NOTE]
该接口通过身份证号、名称、手机号校验是否真实有效(通过查询电信运营商服务接口确认,有效性存在时延)、该接口涉及到运营商三要素-详版费用,如果未购买需要联系商务进行购买。

注:虚拟号段不支持验证,一卡多号(虚拟卡)不支持验证,192中国广电号段不支持验证

http请求方式

[!NOTE]
POST application/x-www-form-urlencoded

http请求地址

[!NOTE]
$SERVICE_URL/v2/auth/operatorsThreeVerifyDetail #其中$SERVICE_URL为生产或测试的地址

http请求参数

除公共必填参数外,还需要传以下参数

参数 类型 是否必填 默认值 说明
name string * 姓名
identityCard string * 证件号
mobile string * 手机号

代码实现

JAVA实现
        RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
        //构建请求参数
        Map<String,Object> params=new HashMap<>();
        params.put("name","易XX");
        params.put("identityCard","500240XXXXXXXXXXXXXXX");
        params.put("mobile","1532XXXXX");
        ResultInfo<Void> ri= requestUtils.doPost("/v2/auth/operatorsThreeVerifyDetail",params);

http返回参数

[!NOTE]
返回response为application/json的数据,其字段说明如下

参数 类型 是否必返回 说明
success bool * 成功true;异常false
data object ? 返回业务内容

data参数说明

参数 类型 是否必返回 说明
orderNo string * 订单号
code int * 0成功 ,2失败
verifyStatus string * 验证结果
excuteStatus string * 执行结果
resultMessage string * 验证失败原因

code参数说明

code msg
0 验证成功
10420 手机号已实名,身份证和姓名均与实名信息不一致。
10421 手机号已实名,手机号和证件号一致,姓名不一致。
10422 手机号已实名,手机号和姓名一致,身份证不一致。

[!NOTE]
返回结果,参考:

//正确响应:
{"data":{"resultMessage":"请求渠道失败","verifyStatus":"VERIFY_OPERATORS_FAIL","excuteStatus":"EXECUTE_FAIL"},"success":true}
//错误响应:
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}

results matching ""

    No results matching ""