平台做注册、做交易、做实名认证，总绕不开一个问题：用户填的姓名和身份证号，到底是不是同一个人？

传统方式要么人工肉眼核对，效率低还容易漏；要么自己接公安数据源，门槛高、周期长。其实不需要那么复杂。传入姓名和身份证号两个参数，接口自动完成一致性核验，秒级返回结果，同时附带性别、生日、地址信息。这就是探数API身份证实名认证接口在做的事。

身份证实名认证API的接入流程不复杂，返回什么、怎么处理三种核验结果，业务侧怎么配合，下面逐一讲。

📋 核验结果长什么样

先看调用这个接口能拿到什么。完整返回结构：

{
    "code": 1,
    "msg": "操作成功",
    "data": {
        "name": "张三",
        "idcard": "330333333333333333",
        "res": "1",
        "description": "一致",
        "sex": "男",
        "birthday": "19660413",
        "address": "河南省郑州市金水区"
    }
}

接口返回两层。外层 code 为 1 说明请求本身没问题，真正需要关注的是 data 里的核验结果：

name 和 idcard 原样返回，方便做入库比对或前端回显。

res 的三个值对应三种完全不同的业务逻辑。搞清楚每个值怎么处理，比调用成功本身更重要。

🔍 这个接口能做什么

官方权威数据源。接口底层对接公安权威数据，核验结果可信度高。平台侧不存储用户身份信息，调用方只需要传参数、拿结果，不需要做额外的数据维护。

高并发场景下也能稳定响应。实测响应时间在 200ms 以内，注册高峰期或活动峰值时不会因为并发量上升出现明显延迟。

二要素一致性核验只需要传姓名和身份证号两个参数，接口在公安数据层面做比对，判断两个要素是否属于同一个人。整个核验过程对用户透明，不需要任何前端交互，后端静默调用即可完成。

核验结果之外，接口同时返回性别、生日、地址三个字段。一次调用拿到四份数据，不需要再单独调用其他接口补充用户基础信息。

🛠️ 怎么接入

接口地址：https://www.tanshuapi.com/market/detail-109

支持 GET 和 POST，按你的后端框架习惯选。

请求参数就三个：

请求示例：

https://www.tanshuapi.com/market/detail-109?key=你的KEY&name=张三&idcard=330333333333333333

服务端返回 JSON，解析 code 和 data.res 两个字段就够了。注意 code 和 res 要分开判断——code 为 1 说明接口调用没出技术问题，res 为 1 才是核验通过了，两者不可混为一谈。

data.res 返回 2 或 3 时，业务侧需要明确告知用户核验失败及原因，不要直接把原始错误码抛给前端展示。

常见场景：如何在注册流程中接入

最简接入三步：用户在注册页填姓名和身份证号，后端携带这两个参数调用接口，解析 data.res，1 放行、2 或 3 提示用户核对信息。整个调用过程对用户无感知，不需要额外的页面跳转。

注册账号、申请接口、在线调试、正式接入。四步，没什么复杂的。注册完在个人中心找到身份证实名认证接口，点申请拿免费测试额度，在调试工具里传入姓名和身份证号跑一遍，确认返回结果符合预期后买套餐集成到应用里。

📋 典型使用场景

用户注册时最烦的是上传身份证照片再等人审核。用二要素验证，用户在注册页填完姓名和身份证号，后端静默调用接口比对，通过直接放行，不通过提示核对信息。全程不需要用户拍照、不需要等待审核，注册流程缩短到几十秒。

金融场景里要防的是身份冒用。用户提交的开户信息里，身份证号和姓名不一定属于同一个人。核验不通过直接阻断开户流程，从源头把身份冒用的路堵死。

政务预约、挂号、共享出行这些实名制场景，需要确认”来办事的人是不是他说的那个人”。传姓名加身份证号，比对结果直接决定是否放行，不需要额外的身份核验步骤。

先用身份证识别接口提取用户上传的身份证图片中的姓名和身份证号，再调用二要素验证接口做一致性比对，两步走完身份核验。探数平台同时提供银行卡三要素、运营商二要素等接口，可以根据业务需要组合使用。

❓ 常见问题

二要素和三要素有什么区别？

二要素验证需要姓名和身份证号两个参数，完成身份一致性核验，同时返回性别、生日、地址信息。三要素验证在二要素基础上增加手机号参数，额外核验手机号是否属于该身份证持有人。如果只需要确认「这个人是不是本人」，二要素足够用；如果需要同时确认手机号归属，再考虑三要素。探数平台同时提供三要素验证接口，可以直接在个人中心找到。

接口响应时间一般多少？

正常网络环境下，接口响应时间在 200ms 以内。这个时间包含网络传输和数据源比对两个环节，具体耗时和用户所在地区的网络状况有关。如果业务对响应时间有要求，建议服务端超时阈值设为 2 秒，留出缓冲空间。

10007 调用次数超限

最常见的生产环境错误。额度用完后接口直接返回这个错误码，需要到个人中心检查剩余次数并续费或升级套餐。建议在业务侧做额度监控，快用完前提前预警，别等用户请求报错了才处理。

210901 参数校验失败

开发阶段最常见的错误。检查 name 和 idcard 是否都传了，身份证号是否为 18 位，姓名中是否有特殊字符需要编码。

其余几个：10001 检查 key 是否传对；10002 确认接口权限是否已开通；10003 到个人中心续期；210902 检查参数值是否符合接口要求。

🔗 相关接口

• 身份证识别 — 识别及提取身份证正反面所有字段信息。
• 银行卡三要素 — 验证银行卡卡号、姓名、身份证号三要素是否一致。
• 运营商二要素 — 验证姓名、身份证号、手机号二要素信息是否一致。
• 手机状态查询 — 运营商空号检测，分类筛选空号、实号、风险号和沉默号。

接口速查

• 接口名称： 身份证二要素验证
• 接口地址： https://www.tanshuapi.com/market/detail-109
• 请求方式： GET / POST
• 必填参数： key、name、idcard
• 返回格式： JSON
• 核验结果： 1 一致 / 2 不一致 / 3 无记录
• 附带字段： 性别、生日、地址
• 数据源： 公安权威数据
• 响应时间： 200ms 以内
• 并发支持： 可支持高并发