正在启动平台

身份证二要素核验idcard-2c

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

1. 基本信息

接口地址https://v1.apizero.cn/api/idcard-2c
请求方法POST
分类kyc
提供方极数本源
计费模式按次付费
单次消耗0 积分
起步价¥0.00 / 1000 次
QPS 限制5 req/s
每日免费额度0 次(已认证用户)
匿名每日额度0 次(无 API Key)
VIP 免费
调用次数

2. 认证

需要 API Key(Authorization: Bearer <key>)。按次计费 ¥0.10/次,核验失败也计费(以上游返回为准)。

获取 API Key:登录 https://apizero.cn/account/keys

3. 请求参数

参数名类型必填说明示例
namestring真实姓名(中文)张三
idcardstring18 位身份证号(末位可为 X)11010519491231002X

4. 请求头

Header类型必填说明示例
AuthorizationstringBearer <你的 API Key>
Content-Typestring请求体格式

5. 请求示例

以下 5 种语言示例都是可直接运行的,只需把 YOUR_API_KEY 替换为实际 Key。

cURL

curl -X POST "https://v1.apizero.cn/api/idcard-2c" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "张三",
  "idcard": "11010519491231002X"
}'

Python

import requests

resp = requests.request(
    "POST",
    "https://v1.apizero.cn/api/idcard-2c",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
    "name": "张三",
    "idcard": "11010519491231002X",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

JavaScript (Node.js)

// Node.js 18+ / 浏览器原生 fetch
const res = await fetch("https://v1.apizero.cn/api/idcard-2c", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "张三",
    "idcard": "11010519491231002X"
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

Go

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := []byte(`{"name":"张三","idcard":"11010519491231002X"}`)
	req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/idcard-2c", bytes.NewBuffer(body))
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(string(out))
}

PHP

<?php
$payload = json_encode([
    "name" => "张三",
    "idcard" => "11010519491231002X",
], JSON_UNESCAPED_UNICODE);

$ch = curl_init("https://v1.apizero.cn/api/idcard-2c");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        "X-Api-Key: YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_TIMEOUT        => 15,
]);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);

6. 响应字段

字段类型说明示例
namestring回显的姓名
idcardstring脱敏后的身份证号
validboolean是否一致:true=一致
result_codenumber100=一致 101=不一致 102=库中无此号
messagestring结果描述

7. 响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "name": "张三",
    "idcard": "110***********002X",
    "valid": true,
    "result_code": 100,
    "message": "一致"
  },
  "request_id": "abc123"
}

8. 错误码

codestatus说明
4000VALIDATION_ERROR缺少必填参数或身份证号格式错误
4022INSUFFICIENT_BALANCE余额不足,请充值后再试
5020UPSTREAM_ERROR上游核验服务不可用
5021UPSTREAM_INVALID上游返回格式异常
5030UPSTREAM_MISSING上游 Token 未配置,联系管理员

9. 变更日志

  • v1.0(2026-06-10)
    • 首次上线:身份证二要素核验。