免费体验，快速对接身份证实名认证API接口说明

为了让您更清晰了解身份证二要素实名认证接口的功能与使用。深智恒际特意列了以下5个方面，引导您便捷对接API接口。即使是非技术人员，也可以借用postman工具进行调试使用。

身份证实名认证接口功能
安全防御功能
身份证实名认证接口对接流程说明
postman工具调试

一、身份证实名认证接口功能

身份证二要素实名认证接口的功能是，根据您传入的姓名与身份证号码，与公民查询中心数据库中该姓名的身份信息进行比对，返回核验结果。

二、安全防御功能（建议了解）

接口防御功能
目前市面上经常有客户遇到不法用户撞库的情况，为了保护客户的业务健康运转，和保障客户套餐余额，我们增加了一个防撞库机制，【同一名字30分钟内调用10次后，再次调用就会触发“403 RATE_LIMIT”，30分钟后重置状态】。

其他相关接口的使用建议：

短信验证码注册阶段：

平台前端增加图形验证码，增加羊毛党操作成本
判断是否为虚拟号码，虚拟号码直接不让请求
限制同一号码在某一时间段内请求次数，例如请求一次后，需要间隔2分钟后才能再次请求
IP限制调用次数和频率，超过次数，直接封IP，限制国外IP

实名注册阶段：

最严谨的方式：人脸活体检测+公安人脸三要素核验
尽量少用身份证二要素接口，羊毛党手里有大量数据
注重短信验证码注册阶段后，可结合手机三要素、银行卡四要素接口进行实名核验
限制连号信息调用接口，例如限制同一个姓名+号码，搭配不同的身份证连号持续调用撞库。

三、身份证实名认证接口对接流程说明

对接步骤

您先购买【免费测试套餐】
从管理控制台获取【AppCode】
从【身份证实名认证商品详情页】获取请求示例、调用地址、请求参数进行对接（见下图）
设定业务参数判断（见下列说明）
了解接口业务相关知识

阿里云详情页API接口信息

业务参数设定：

当 http响应状态码为200 时，以state参数返回值来做业务判断：
- state参数返回值为 1 : 查询成功, 二要素一致
- state参数返回值为 2 :查询成功, 二要素不一致
当 http响应状态码为400 时，以state参数返回值为4时：
- status:“QUERY_FAILED”，为库无
当 http响应状态码为400 时，无state参数返回值：
- status": “INVALID_ARGUMENT”，为传入参数格式错误

业务相关知识——核验结果返回说明：
核验结果返回“库无”，有以下几种原因：

现役军人、武警官兵、特殊部门人员及特殊级别官员；
退役不到2年的军人和士兵（根据军衔、兵种不同，时间会有所不同，一般为2年）；
户口迁出，且没有在新的迁入地迁入；
户口迁入新迁入地，当地公安系统未将迁移信息上报到公安部（上报时间地域不同而有所差异）；
更改姓名，当地公安系统未将更改信息上报到公安部（上报时间因地域不同而有所差异）；
移民；未更换二代身份证；
死亡。
身份证号确实不存在

四、postman工具调试

小办法：

在使用阿里云提供的请求示例对接过程中，如果遇到困难，可以尝试使用postman调试，调通后导出code直接使用。
Postman调试简单，非技术人员，平常也可以使用postman调用接口，核验相关信息

Postman【下载】
1.将AppCode放在Header中
请求Header中添加的Authorization字段；配置Authorization字段的值为“APPCODE ＋半角空格＋APPCODE值”。

示例如下：
Authorization:APPCODE 3F2504E04F8911D39A0C0305E82C3301

2.配置body参数：
请求体格式选择：
‘Content-Type’, ‘application/x-www-form-urlencoded; charset=UTF-8’

body参数设置：参考商品详情页api信息：

接口调通后，点击code，进行导出代码

3.导出代码（如有需要，直接导出使用)
选择你所需要的代码类型，整段复制代码使用即可