二要素校验

服务说明

[!NOTE]
君子签提供个人二要素校验,该接口主要通过姓名+身份证号进行校验。该接口涉及到身份认证费用,如果未购买需要联系商务进行购买。

http请求方式

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

http请求地址

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

http请求参数

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

参数 类型 是否必填 默认值 说明
name string * 姓名
identityCard 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","50024XXXXXXXXXXXXX");//

        ResultInfo<Void> ri= requestUtils.doPost("/v2/auth/userValid",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
    "name" => "易XX",
    "identityCard" => "50024XXXXXXXXXXXXX"
);
//发起请求
$response=$requestUtils->doPost("/v2/auth/userValid",$request);

http返回参数

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

参数 类型 是否必返回 说明
success bool * 成功true;异常false
msg string ? 异常时,返回异常原因
resultCode string ? 异常时返回
data object ? 业务信息

[!NOTE]
data为JSON对象,参考:

参数 类型 是否必返回 说明
message string * 消息
valid bool * 验证成功与否
seqNo string * 编号
code string * 状态码

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

//正确响应:
{"data":{"message":"验证一致","valid":true,"seqNo":"BF8J62A81910301649","code":"10000"},"success":true}

//错误响应:
{"data":{"message":"验证不一致","valid":false,"seqNo":"WIHJ110Z1910301650","code":"10000"},"success":true}

results matching ""

    No results matching ""