运营商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 | string | * | 0成功 ,2失败 |
verifyStatus | string | * | 验证结果 |
excuteStatus | string | * | 执行结果 |
resultMessage | string | * | 验证失败原因 |
code参数说明
code | msg |
---|---|
0 | 验证成功 |
10420 | 手机号已实名,身份证和姓名均与实名信息不一致。 |
10421 | 手机号已实名,手机号和证件号一致,姓名不一致。 |
10422 | 手机号已实名,手机号和姓名一致,身份证不一致。 |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":{"code":"0","excuteStatus":"EXECUTE_SUCCESS","orderNo":"loOO1y2ozwnnyte8k","verifyStatus":"VERIFY_OPERATORS_SUCCESS"},"success":true}
//错误响应:
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}