身份证实名认证接口Java调用示例

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

身份证实名认证接口又称身份证二要素验证，即输入姓名、身份证号，校验此两项是否匹配，同时返回生日、性别、籍贯等信息。

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

例如：交通领域

1.火车票、飞机票购买：在购买火车票、飞机票时，需要进行身份验证。身份证实名接口可以帮助票务系统快速核实乘客身份信息，确保票务销售的合法性和安全性。例如，乘客在网上购买火车票或飞机票时，系统可以通过接口查询乘客的身份证信息，进行实名购票。

2.网约车平台：网约车平台需要对司机和乘客的身份进行验证。身份证实名接口可以帮助平台确保司机和乘客的身份真实可靠，提高出行安全。例如，司机在注册网约车平台时，平台可以通过接口查询司机的身份证信息，进行背景审查；乘客在叫车时，平台也可以对乘客的身份进行验证，保障双方的安全。

例如：社交领域

1.社交平台注册：社交平台为了营造健康、安全的社交环境，需要对用户身份进行验证。身份证实名接口可以帮助社交平台核实用户身份，防止虚假注册和不良行为。例如，用户在注册社交账号时，平台可以要求用户提交身份证信息，并通过接口进行验证，确保用户身份真实可靠。

2.网络直播平台：网络直播平台需要对主播和观众的身份进行验证。身份证实名接口可以帮助平台确保主播和观众的身份真实有效，维护直播平台的秩序和安全。例如，主播在注册直播账号时，平台可以通过接口查询主播的身份证信息，进行身份验证；观众在观看直播时，平台也可以对观众的身份进行验证，防止恶意攻击和不良行为。

三、如何用Java快速调用该接口呢？

我们以下为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)死亡。