能力说明
身份证二要素核验是最基础的实名能力：通过权威数据源比对「姓名 + 身份证号」是否一致，返回一致、不一致、无此号等明确结论。相比自建校验，接口侧已完成校验位、地区码、出生日期合法性等前置判断，无效号码不会产生费用。
接口不返回、不存储任何明文证件信息。每次调用仅留存结果码、耗时与流水号，用于对账与排障。
核验结论
| result | 含义 | 说明 |
|---|---|---|
| MATCH | 一致 | 姓名与身份证号属于同一人 |
| NO_MATCH | 不一致 | 姓名与身份证号不匹配 |
| NO_ID | 无此身份证号 | 身份证号在库中不存在 |
接口说明
完整的请求参数、返回字段与多语言示例见 身份证实名认证接口文档。
POST/api/v1/idcard
Content-Type: application/json
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name* | string | 是 | 姓名，中文全名，2-30 个字符 |
| idcard* | string | 是 | 18 位居民身份证号，末位可为 X |
请求示例
curl -X POST "https://smrz.anyixing.com.cn/api/v1/idcard" \ -H "Content-Type: application/json" \ -H "X-Api-Key: aB3xK9mP2qR7sT5vW8yZ4nC6dF1gH0jL" \ -d '{"name":"张三","idcard":"330102199001010016"}'
返回示例
{
"code": 0,
"msg": "核验一致",
"data": {
"result": "MATCH",
"fee": 0.20,
"balance": 4986.40,
"req_id": "a1b2c3d4e5f6a7b8",
"cost_ms": 218
}
}
适用场景
这些环节都能用上
1
用户注册实名
注册环节校验用户提交的姓名与身份证号是否一致，拦截虚假身份。
2
内容发布实名
论坛、社区、招聘等场景要求发布者完成实名，降低违规风险。
3
员工入职核验
批量核验候选人提供的身份信息，减少人工比对成本。
4
账号找回验证
高风险操作前二次核验身份，作为账号归属的辅助证明。
常见问题
你可能关心的问题
会不会保存我提交的姓名和身份证号？
不会。接口仅做实时比对，请求结束后不落地存储明文证件信息，调用日志只保留结果码与流水号。
格式错误的身份证号会扣费吗？
不会。本地会先做校验位与格式预校验，格式不合法直接返回参数错误，不产生调用与扣费。
支持 15 位老身份证号吗？
支持。系统会自动升位到 18 位后再核验。
