运行中付费身份核验

身份证二要素核验

API

校验「真实姓名 + 18 位身份证号」是否与公安权威库一致，秒级返回。适用于注册实名、下单风控、账户绑定等场景。仅返回是否一致，不返回任何额外户籍信息；身份证号在响应中脱敏回显。请在取得被核验人授权后调用。

文档

由极数本源提供·更新于 2 天前

累计调用

268ms

平均响应

100.00%

服务可用性

访问限制

查看更多方案 →

我的方案按量计费升级套餐

QPS 5

无登录免费额度—

本接口无公共免费额度，请开通会员或按次/点数计费

无 Key 调用

无匿名额度 · 需 API Key

登录免费

无登录免费额度

黄金会员

每日 50,000 次 · QPS 60

企业会员

每日 1,000,000 次 · QPS 120

文档链接

复制文档地址

https://apizero.cn/aidocs/idcard-2c/raw.md

接口请求地址

https://v1.apizero.cn/api/idcard-2c

接口请求方式

POST

请求参数格式

APPLICATION/JSON

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/idcard-2c

接口信息备注

需要 API Key（Authorization: Bearer <key>）。按次计费 ¥0.10/次，核验失败也计费（以服务返回为准）。

请求参数说明

名称	类型	说明
name	string	必填 · 真实姓名（中文） · 示例：张三
idcard	string	必填 · 18 位身份证号（末位可为 X） · 示例：11010519491231002X

请求头说明

名称	类型	说明
Authorization	string	必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。
Content-Type	string	可选 · 请求体格式

返回字段说明

名称	类型	说明
name	string	回显的姓名
idcard	string	脱敏后的身份证号
valid	boolean	是否一致：true=一致
result_code	number	100=一致 101=不一致 102=库中无此号
message	string	结果描述
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "name": "张三",
    "idcard": "110***********002X",
    "valid": true,
    "result_code": 100,
    "message": "一致"
  },
  "request_id": "abc123",
  "tips": "极数本源 · https://apizero.cn"
}

加载接口文档…

名称

类型

说明

name

string

必填 · 真实姓名（中文） · 示例：张三

idcard

string

必填 · 18 位身份证号（末位可为 X） · 示例：11010519491231002X

名称

类型

说明

Authorization

string

必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

Content-Type

string

可选 · 请求体格式

名称

类型

说明

name

string

回显的姓名

idcard

string

脱敏后的身份证号

valid

boolean

是否一致：true=一致

result_code

number

100=一致 101=不一致 102=库中无此号

message

string

结果描述

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{ "code": 0, "msg": "成功", "data": { "name": "张三", "idcard": "110***********002X", "valid": true, "result_code": 100, "message": "一致" }, "request_id": "abc123", "tips": "极数本源 · https://apizero.cn" }