核心能力
身份证号/姓名核验
输入身份证号 + 姓名,返回是否一致
权威数据源
直连权威数据库
实时核验
对接权威数据源实时返回结果
结果明确
一致 / 不一致 / 库中无此号
应用场景
接口参数与签名
诺正通所有接口采用统一的 webservice + MD5 签名鉴权机制, 全面兼容网站、APP、H5、微信小程序。通用鉴权参数、签名规则、返回结构、错误码由所有接口共享, 请前往 开发者中心 - 通用规范 查看完整说明。
🔐 通用鉴权参数(摘要)
所有接口共享 3 个鉴权参数:mall_id(商户ID)、tm(13位毫秒时间戳,防重放)、sign(MD5 签名)。
签名公式:md5(mall_id + 业务参数 + tm + appkey)。
📋 本接口业务参数
| 参数名 | 中文名 | 必填 | 说明 |
|---|---|---|---|
| realname | 姓名 | 必填 | 需要认证的用户真实姓名 |
| idcard | 身份证号 | 必填 | 需要认证的身份证号,最后一位为 X 需转小写 x |
🔏 签名规则(摘要)
完整签名算法、Java/PHP/Python/Go/Node.js 多语言代码示例已统一整理在开发者中心 - 通用规范 / 签名规则。
📦 返回结构(摘要)
所有接口返回 JSON,包含 data.code(业务结果码)和status(服务状态码)两层。 完整 JSON 示例见通用规范 / 返回结构。
错误码速查表
所有接口共享的错误码体系
完整错误码表(成功 1000 / 不一致 1001 / 鉴权失败 / 账户欠费等 20+ 个 code)已统一整理, 请前往 开发者中心 - 通用规范 / 错误码 查看完整表格和解决方案。
查看完整错误码表 →权威数据
直连权威源
实时响应
直连权威源实时核验
数据权威
结果来自权威数据库
常见问题
数据来源权威吗?▼
是的,我们直连权威数据库,确保数据准确性和实时性。
单次调用耗时多久?▼
接口为实时核验,一次请求返回一次结果;耗时取决于网络与权威源响应速度。
支持哪些字段?▼
输入身份证号 + 姓名,返回是否一致。
如何申请免费试用?▼
点击页面顶部「申请免费试用」按钮,填写企业信息后 1 个工作日内开通。
身份证二要素核验具体核验什么?▼
身份证二要素核验只做一件事:把提交的姓名与身份证号送到权威数据库比对,返回一致、不一致或库中无此号。它不返回照片、住址、签发机关等信息,也不做活体判断,所以能挡住信息造假,挡不住本人身份被冒用。需要确认操作者是不是本人时,要叠加人脸核身或手机号三要素核验。
身份证核验 API 支持哪些调用方式?▼
身份证核验 API 支持 POST 与 GET 两种调用方式,请求需带商户ID、姓名、身份证号、13 位毫秒时间戳与签名,返回核验结论字段。批量核验建议走 POST,按配额做分片并发,并对失败记录保留幂等键,避免重放时重复计费。
身份证二要素核验和身份证实名认证接口是同一个产品吗?▼
是同一个产品。站内的「身份证实名认证接口」「身份证二要素核验」「身份证核验 API」指的是同一套能力:输入姓名与身份证号,返回是否与权威数据源一致。区别只在叫法,接入方式与计费口径完全一致。