身份证实名认证接口如何用Java进行调用

一、什么是身份证实名认证接口？

身份证实名认证接口又叫身份实名认证、身份证二要素、身份证核验接口、实名核验接口等，该接口叫法非常多，但是他的入参都是一样的，核验姓名和身份证号码是否一致，并返回性别、籍贯、生日等具体信息。

二、身份证实名认证接口适用于哪些场景？

身份证实名认证接口使用场景也非常的丰富，比如：

1.政务服务：

（1）日常政务登记：如政务大厅的访客登记、自助服务设备的业务办理、各类在线政务服务的注册与申请等，可快速验证身份，提高办事效率，减少人工审核的时间和错误率。

（2）资格审核与认证：在涉及福利申请、证件办理（如社保卡、居住证等）、考试报名等场景，确保申请人身份真实，防止冒领、虚假申报等情况。

2.金融领域：

（1）账户开户与管理：在银行、证券、保险等金融机构，无论是线下网点还是线上平台的账户开立、激活，以及账户信息变更、挂失等业务，都需要验证客户身份证信息，保障账户安全，符合反洗钱等监管要求。

（2）贷款与信用评估：金融机构在发放贷款前，通过身份证实名认证接口核实借款人身份，结合其他信息进行信用风险评估，降低贷款违约风险。

（3）金融交易与支付：在大额转账、证券交易、线上支付等重要金融交易环节，验证用户身份，确保是本人操作，防止账户被盗用或冒用进行非法交易。

三、如何用Java实现身份证实名认证接口调用？

下面我们以阿里云接口为例，具体实例代码如下：

	public static void main(String[] args) {
	    String host = "https://kzidcardv1.market.alicloudapi.com";
	    String path = "/api-mall/api/id_card/check";
	    String method = "POST";
	    String appcode = "你自己的AppCode";
	    Map<String, String> headers = new HashMap<String, String>();
	    //最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105
	    headers.put("Authorization", "APPCODE " + appcode);
	    //根据API的要求，定义相对应的Content-Type
	    headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
	    Map<String, String> querys = new HashMap<String, String>();
	    Map<String, String> bodys = new HashMap<String, String>();
	    bodys.put("name", "name");
	    bodys.put("idcard", "idcard");


	    try {
	    	/**
	    	* 重要提示如下:
	    	* HttpUtils请从
	    	* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
	    	* 下载
	    	*
	    	* 相应的依赖请参照
	    	* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
	    	*/
	    	HttpResponse response = HttpUtils.doPost(host, path, method, headers, querys, bodys);
	    	System.out.println(response.toString());
	    	//获取response的body
	    	//System.out.println(EntityUtils.toString(response.getEntity()));
	    } catch (Exception e) {
	    	e.printStackTrace();
	    }
	}

正确返回示例代码：

{
    "msg": "成功",
    "success": true,
    "code": 200,
    "data": {
        "birthday": "19840816",
        "result": 1,//1.不一致 0.一致
        "address": "浙江省杭州市淳安县",//地址
        "orderNo": "202406271440416095174",//订单编号
        "sex": "男",//性别
        "desc": "不一致"//描述
    }
}
极少数特殊情况会返回【库无】请留意：    
    (1)现役军人、武警官兵、特殊部门人员及特殊级别官员；
    (2)退役不到2年的军人和士兵（根据军衔、兵种不同，时间会有所不同，一般为2年）；
    (3)户口迁出，且没有在新的迁入地迁入；
    (4)户口迁入新迁入地，当地公安系统未将迁移信息上报到公安部（上报时间地域不同而有所差异）；
    (5)更改姓名，当地公安系统未将更改信息上报到公安部（上报时间因地域不同而有所差异）；
    (6)移民；
    (7)未更换二代身份证；
    (8)死亡。
    (9)身份证号确实不存在