身份证二要素实名认证接口是一种用于验证个人身份信息真实性的应用程序接口（API）。它通过核验用户提供的 “姓名” 和 “身份证号码” 这两个关键要素，来判断是否与官方权威数据源（通常来自公安部公民身份信息数据库或其授权机构）的记录相匹配。

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

二要素”指的是用户的 姓名 与身份证号码。身份证二要素实名认证接口是通过核验用户提供的身份证二要素，与权威数据库中的实名信息进行比对，来核实用户身份真实性。其核心价值在于：

身份真实性核验：防止冒用身份、虚假注册；

满足合规要求：符合《网络安全法》《个人信息保护法》等法规对实名制的要求；

提升风控能力：为后续业务的信用评估、反欺诈等提供基础数据支撑。

通过身份证二要素实名认证接口对用户身份真伪进行判断，具备高准确率、低延迟、高并发处理等优势。

二、接口技术规范详解

1. 接口地址与方法

URL：https://api.shumaidata.com/v4/id_card/check

Method：GET/POST

协议：HTTPS（保障传输安全）

2. 请求参数

appid:数脉分配的唯一标识，用于身份鉴权

Timestamp:当前时间的毫秒数

sign：签名

Idcard:核验用户的身份证号码

name:核验用户的真实姓名

3. 返回字段说明

success:接口调用成功标识，true为成功，false为失败；若失败会有对应描述或状态码（如msg:参数错误code:400）

code:状态码，成功为200，其他均为失败状态码

msg：状态码对应的说明描述

data:验证结果的详细信息

result:验证结果，0为一致，1为不一致，2为无预留记录

orde_no:订单号

desc:验证结果描述信息

sex:性别

birthday:生日

address:籍贯

4. code错误码说明

200：验证成功

400：参数错误

404：请求资源不存在

500：系统内部错误，请联系服务商

601：未开通接口权限

602：账号停用

603：余额不足，请充值

604：接口停用

605：次数不足，请购买套餐

1001：其他，以实际返回为准

三、身份证二要素实名认证接口应用场景

用户注册/登录：在注册环节强制实名，防止机器人或冒用身份、虚假账号；

金融开户/支付验证：满足 KYC（了解你的客户）合规要求；

在线医疗问诊：确保患者身份真实，便于病历管理；

景区/场馆预约：落实实名制购票与入园政策；

网约车/共享出行：司机与乘客双向实名认证，提升安全等级。