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

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

目录：

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

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

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

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

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

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

短信验证码注册阶段：

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

实名注册阶段：

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

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

对接步骤

1. 您先购买【免费测试套餐】

2. 从管理控制台获取【AppCode】

3. 从【身份证实名认证商品详情页】获取请求示例、调用地址、请求参数进行对接（见下图）

4. 设定业务参数判断（见下列说明）

5. 了解接口业务相关知识
   

阿里云详情页API接口信息

业务参数设定：

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

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

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

四、postman工具调试

小办法：

1. 在使用阿里云提供的请求示例对接过程中，如果遇到困难，可以尝试使用postman调试，调通后导出code直接使用。
2. 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.导出代码（如有需要，直接导出使用)
选择你所需要的代码类型，整段复制代码使用即可