快速接入
三个核验接口各自独立成页，请求方式、参数、返回字段、错误码都写在各自页面里。这里只说明三个接口完全一致的部分：地址、鉴权、外层返回结构、计费口径与频率规则。
接口地址统一使用 HTTPS：https://smrz.anyixing.com.cn。请勿用 http:// 调用——虽然会 307 重定向，但部分不跟随重定向的客户端会直接失败。
不想写代码？复制一段文字丢给 Claude Code / Cursor / WorkBuddy，
它会自己下载技能、配好密钥、把核验接进你的项目。
去复制指令 →
四步走完
- 注册账号 并充值额度（额度 2 年有效）
- 在 控制台 → API 密钥 获取 32 位密钥
- 打开要用的接口文档，照着它的「请求示例」发一次
- 用 code 判断调用状态，用 data.result 判断核验结论
选择接口
| 接口 | 要素 | 适用场景 | 文档 |
|---|---|---|---|
| 身份证实名认证 | 姓名 + 身份证号 | 注册实名、内容发布、入职核验 | 查看 → |
| 银行卡实名认证 | 姓名 + 身份证 + 卡号 + 预留手机号 | 提现绑卡、代付下发、企业付款 | 查看 → |
| 手机号实名认证 | 姓名 + 手机号（可加身份证号） | 账号安全、风控准入、防批量注册 | 查看 → |
鉴权方式
所有接口通过请求头 X-Api-Key 鉴权，密钥为 32 位字母数字组合，在控制台的 API 密钥 页面获取。
X-Api-Key: aB3xK9mP2qR7sT5vW8yZ4nC6dF1gH0jL
- 密钥与账号绑定，调用费用从该账号余额扣减
- 请勿写在前端代码、小程序包、公开仓库里，应由服务端转发调用
- 密钥疑似泄露可在控制台立即重置，旧密钥即时失效
- 鉴权失败返回 code = 1002，不计费
返回结构
三个接口共用同一层外层结构，业务字段都在 data 里，具体字段见各接口文档的「返回参数」。
{
"code": 0,
"msg": "核验一致",
"data": { ... }
}
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 调用状态码。0 = 调用被正常处理；非 0 = 调用失败，data 为 null |
| msg | string | 状态描述，可直接写入日志 |
| data | object | 业务结果，字段按接口不同，见各接口文档 |
最容易踩的坑：code = 0 只代表这次调用被正常处理并计费。
「姓名与证件号不一致」属于正常业务结论，同样返回 code = 0，
必须再看 data.result 才能下判断。只判断 code 会把「不一致」当成调用成功而误放行。
计费与额度
- 按次计费，¥50.00 元起充，单价按所购套餐档位执行，后续充值余额不改变单价，详见 价格与套餐
- 核验结论为「不一致」「无此号码」同样计费，这属于有效核验
- 参数错误、鉴权失败、余额不足、频率超限、防刷拦截、上游异常不计费，也不扣减额度
- 充值额度自到账起 2 年内有效，按笔计算，消费时优先扣最早到期的部分
- 每次调用的费用、余额、流水号都可在 控制台 → 调用记录 查看
频率限制
- 单账号默认 20 QPS，可按需申请提高
- 超出 QPS 返回 1004，建议本地限流并退避重试
- 另有针对「同一主体反复试不同对象」的防刷规则，阈值按接口不同，写在各接口文档的「频率与防刷」
- 批量场景建议 5–10 并发，过高并发容易触发上游风控
常见问题
核验「不一致」会扣费吗？
会。一致与不一致都是有效核验，按次计费。只有参数错误、鉴权失败、余额不足、频率超限、上游异常这类非业务失败不计费。
平台会保存我提交的证件信息吗？
不保存明文。平台只做实时比对，调用记录里仅保留结果码、费用、耗时、流水号，以及用于后台检索对账的 32 位摘要值。
可以在前端（H5 / 小程序）直接调用吗？
不建议。密钥会暴露在客户端。正确做法是你的服务端接收前端请求，再带密钥调用本接口。
三个接口的密钥是同一个吗？
是。一个账号一把密钥，三个接口通用，费用从同一份余额扣减。
为什么同样参数查两次，返回内容完全一样？
核验结论来自权威数据源，同一组信息在数据未变更的情况下结论稳定，因此返回一致属正常现象。两次调用均按次计费。
「核验频次超限」是什么？
为了防止有人拿真实号码去猜姓名、或拿真实姓名去批量试号码，平台对「同一主体 + 多个不同对象」的组合做了频率限制，触发返回 1006。正常业务（一人一次）不会触发；批量核验确实需要调整阈值的，联系客服说明用途即可。
如何对账？
控制台的调用记录页支持按接口、结果、日期筛选，显示每次费用与余额变动，可与你的业务日志按 req_id 对齐。
