一、接口介绍
验证身份证与姓名是否匹配，查询身份证信息。如校验通过,接口返回生日、性别、地址等信息。广泛应用于信贷、安防、银行、保险等行业及各种身份核查场景。
注意：当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。 当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。
二、使用案例截图
三、API文档
3.1身份证实名验证
3.1.1接入点说明：
验证身份证与姓名是否匹配，查询身份证信息。返回生日、性别、地址等信息。
注意：当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。
当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。
3.1.2接口地址：
http[s]://route.showapi.com/1072-1?showapi_appid=替换自己的值&showapi_sign=替换自己的值。
3.1.3更新频率:
依据身份证中心更新频率，每次返回最新数据。
3.1.4返回格式:
json
3.1.5请求参数
3.1.6返回参数
| 参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| birthday | String | 1991-11-04 | 生日 |
| ret_code | Number | 0 | 0为成功，计费，其余为失败，不计费 |
| sex | String | F | 性别：M为男性，F为女性 |
| order | String | 145801957588529905 | 相关流水号 |
| county | String | 清徐县 | 区县 |
| address | String | 山西太原市清徐县 | 详细地址 |
| province | String | 山西省 | 省 |
| code | Number | 0 | 验证标示 0：匹配 1：不匹配 2：无此身份证号码 3：身份证号与姓名匹配，照片比对失败 4：参数不能为空 5：四要素匹配成功，照片比对失败 6：四要素匹配失败，照片比对成功 7: 四要素匹配成功，照片异常 12：身份证号码不合法 13: 照片质量异常 14: 姓名异常 15: 暂不支持该地域校验 100：渠道异常，请稍后再试 101：验证信息重复输入，避免恶意验证请间隔60秒以上再次核验 103：24小时内相同姓名或卡号核验次数超限 104：decrypt参数异常 202：姓名加密信息有误，请检查 203：身份证加密信息有误，请检查 205：开始时间加密信息有误，请检查 206：结束时间加密信息有误，请检查 207：人像照片加密信息有误，请检查 |
| msg | String | 匹配 | 说明 |
| city | String | 太原市 | 城市 |
3.1.7请求代码示例
以下是JAVA代码示例:
//更多说明请访问仓库地址：https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest("http://route.showapi.com/1072-1","showapi_appid","showapi_sign")
.addTextPara("idcard","")
.addTextPara("name","")
.post();
System.out.println(res);
3.1.8返回示例
{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "60d2da870de3769d4d2df7b4",
"showapi_res_body": {
"birthday": "1991-11-04",
"ret_code": 0,
"sex": "F",
"order": "145801957588529905",
"county": "清徐县",
"address": "山西太原市清徐县",
"province": "山西省",
"code": 0,
"msg": "匹配",
"city": "太原市"
}
}
四、工具
4.1身份证OCR图片识别
4.1.1接入点说明：
自动识别出二代居民身份证正反面的包括姓名、性别、民族、出生日期、住址、身份证号等信息。
4.1.2接口地址：
http[s]://route.showapi.com/1389-4?showapi_appid=替换自己的值&showapi_sign=替换自己的值
4.1.3返回格式:
Json
4.1.5请求参数
4.1.6返回参数
4.1.7请求代码示例
以下是JAVA代码示例:
//更多说明请访问仓库地址：https://github.com/showapi-public/showapi_sdk_java
//这里需要替换为你自己的showapi_appid和showapi_sign，你可以在这里找到 https://www.showapi.com/console#/myApp
String res=new ShowApiRequest("http://route.showapi.com/1072-15","showapi_appid","showapi_sign")
.addTextPara("image_base64","")
.post();
System.out.println(res);
4.1.8返回示例
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id":"ce135f6739294c63be0c021b76b6fbff",
"showapi_res_body": {
"msg": "识别成功!",
"birthday": "198X-0X-XX",
"nationality": "汉",
"sex": "男",
"name": "王XX",
"headImgBase64": "若需要该字段值请使用身份证识别返照接口",
"addr": "湖北省武汉市.....",
"ret_code": 0,
"idNo": "*********01211122"
}
}
4.1.9输入限制
- 图片格式：JPEG、JPG、PNG、BMP、GIF。
- 图像大小：图像大小不超过3M。
- 图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。
- URL地址中不能包含中文字符。
五、应用场景
金融服务：在金融服务中，银行卡核验可以用于验证用户的银行卡信息，确保用户提供的银行卡信息是正确的，从而提高交易的安全性。
实名认证：在各种应用场景中，身份证核验可以用于实名认证，例如在电商平台上，用户需要进行实名认证才能进行购物，身份证核验可以用于验证用户的身份信息。
政府公共服务：在政府公共服务中，身份证核验可以用于验证用户的身份信息，例如在办理证件、领取补贴等方面。
物流服务：在物流服务中，银行卡核验可以用于验证用户的支付信息，从而确保物流费用的支付安全。
教育服务：在教育服务中，身份证核验可以用于验证学生的身份信息，例如在高考报名、学生证申请等方面。
六、加密版使用说明
官网查看加密规则
