身份证实名认证接口

API 文档 / 身份证实名认证

核验姓名与身份证号是否属于同一人，返回一致 / 不一致 / 无此号三种结论。

请求地址

POST/api/v1/idcard起步 ¥0.20 / 次 · 阶梯价

完整地址：https://smrz.anyixing.com.cn/api/v1/idcard
请求方式：POST　Content-Type：application/json　鉴权：X-Api-Key
核验要素：二要素：name + idcard

本接口判断「这个身份证号是不是这个人的」。提交姓名与 18 位身份证号，平台与权威数据源比对后返回明确结论。接口侧已内置校验位、出生日期、15 位升 18 位等前置判断，格式不合法的号码在本地就被拦下，不会发起核验，也不产生费用。

请求参数

参数	类型	必填	说明	示例
name*	string	是	姓名，中文全名，2–30 个字符，支持少数民族姓名中的「·」	张三
idcard*	string	是	18 位居民身份证号，末位可为 X/x；传 15 位会自动升位后再核验	330102199001010012

请求示例

curl

curl -X POST "https://smrz.anyixing.com.cn/api/v1/idcard" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: aB3xK9mP2qR7sT5vW8yZ4nC6dF1gH0jL" \
  -d '{"name":"张三","idcard":"330102199001010012"}'

PHP

<?php
$payload = '{"name":"张三","idcard":"330102199001010012"}';

$ch = curl_init('https://smrz.anyixing.com.cn/api/v1/idcard');
curl_setopt_array($ch, array(
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
    CURLOPT_HTTPHEADER     => array(
        'Content-Type: application/json',
        'X-Api-Key: aB3xK9mP2qR7sT5vW8yZ4nC6dF1gH0jL'
    ),
));
$res  = curl_exec($ch);
curl_close($ch);
$json = json_decode($res, true);
if ($json['code'] === 0) {
    // data.result 为核验结论
}

Python

import requests

resp = requests.post(
    'https://smrz.anyixing.com.cn/api/v1/idcard',
    json={"name":"张三","idcard":"330102199001010012"},
    headers={'X-Api-Key': 'aB3xK9mP2qR7sT5vW8yZ4nC6dF1gH0jL'},
    timeout=10,
)
data = resp.json()
if data['code'] == 0:
    print(data['data']['result'])

返回参数

字段	类型	说明
code	int	调用状态码，0 表示调用被正常处理，不代表核验一致
msg	string	状态描述，可直接写入日志
data.result	string	核验结论，取值见下方「核验结论」
data.fee	decimal	本次调用实际扣费金额（元）
data.balance	decimal	调用后的账户可用余额（元）
data.req_id	string	本次请求流水号，排查问题时提供此值
data.cost_ms	int	接口耗时（毫秒）

返回示例

调用成功（业务结论为一致）

{
  "code": 0,
  "msg": "核验一致",
  "data": {
    "result": "MATCH",
    "fee": 0.20,
    "balance": 986.40,
    "req_id": "a1b2c3d4e5f6a7b8",
    "cost_ms": 218
  }
}

调用失败（余额不足）

{
  "code": 1003,
  "msg": "余额不足，请充值后重试",
  "data": null
}

核验结论

仅当 code = 0 时存在 data.result。

data.result	含义	说明	计费
MATCH	核验一致	姓名与身份证号属于同一人	计费
NO_MATCH	核验不一致	该身份证号存在，但不属于所提交的姓名	计费
NO_ID	无此身份证号	该号码在权威库中不存在	计费

错误码

code	含义	说明与处理
0	调用成功	按 data.result 判断核验结论，已计费
1001	参数错误	缺少必填字段、字段格式不合法或校验位错误。本地即拦截，未计费，也不会产生调用记录
1002	鉴权失败	密钥缺失、无效、已重置，或账号被停用。未计费
1003	余额不足	账户可用余额低于本次单价，充值后重试。未计费
1004	频率超限	超出账号的 QPS 上限。未计费，退避后重试
1005	接口不可用	该接口未对本账号开放，或平台侧临时关闭。未计费，联系客服确认
1006	核验频次超限	触发了防刷规则（同一主体短时间内在试多个不同对象）。未计费，等窗口期过后再试，详见本页「频率与防刷」
2001	上游超时	数据源响应超时或繁忙。未计费，按指数退避重试
2002	上游异常	数据源返回异常。未计费，记录 req_id 联系客服

计费规则

单价按账号累计充值额所属档位执行，起步 ¥0.20 / 次，档位越高单价越低。
一致、不一致、无此号都属于有效核验，均计费。
参数错误、鉴权失败、余额不足、防刷拦截、上游异常不计费。

频率与防刷

账号级 QPS 上限为 20，超出返回 1004。除 QPS 外，为防止有人拿真实号码猜姓名、或拿真实姓名批量试号码，另设以下防刷规则，触发返回 1006：

同一身份证号，60 分钟内出现 ≥5 个不同姓名 → 拦截
同一姓名，60 分钟内查询 ≥5 个不同身份证号 → 拦截
计数是全局的，不区分账号——换账号也不能绕过。

正常业务（同一批用户一人一次）不会触发。如果是批量核验且确有需要，联系客服说明用途可调整阈值。

注意事项

不返回、不存储姓名与身份证号的明文，调用记录仅保留结果码与 32 位摘要值。
校验位错误的号码在本地被拦截（返回 1001），不计费、不留调用记录。
15 位一代身份证会自动升位后核验，返回结果针对升位后的 18 位号码。
判定依据是权威数据源的实名登记信息，军人证件、港澳台居民居住证、护照不在支持范围。