二要素校验-非大陆居民

服务说明

[!NOTE]
君子签提供个人二要素校验（非大陆居民）。该接口涉及到身份认证费用，如果未购买需要联系商务进行购买。

http请求方式

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

http请求地址

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

http请求参数

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

参数	类型	是否必填	默认值	说明
name	string	*		姓名
identityCard	string	*		证件号
type	string	*		证件类型(414:支持中国颁发、定居国外的中国公民护照（华侨护照）,516:港澳居民来往内地通行证,511台湾居民来往大陆通行证，553:外国人永久居留证)
nation	string	*		国籍(三字码,如:中国 ,三字码为：CHN)；type=414/516/511 时，填写中国三字码；type=553时，填写自己国籍三字码

代码实现

JAVA实现

        Map<String, Object> params = bodyParams;
        String url = SERVICE_URL + "/v2/auth/userValidDetail";
        params.put("name", "倪XXX");
        params.put("identityCard", "530XXXXXX");
        params.put("type", "511");
        params.put("nation", "CHN");

        String str = HttpClientUtils.init().getPost(url, null, params, true);
        System.out.println(str);

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