运营商3要素认证

接口说明

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

注：虚拟号段不支持验证，一卡多号（虚拟卡）不支持验证，192中国广电号段不支持验证

http请求方式

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

http请求地址

[!NOTE]
$SERVICE_URL/v2/auth/operatorsThreeVerify #其中$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/operatorsThreeVerify",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
    "name" => "易XX", //TODO *
    "identityCard" => "500XXXXXXXXXXXX", //TODO *
    "mobile" => "153XXXXXXXXX"
);
//发起请求
$response=$requestUtils->doPost("/v2/auth/operatorsThreeVerify",$request);

http返回参数

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

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

data参数说明

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

[!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 ""