<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 车牌车主核验

> 车牌号与车主姓名一致性核验，快速判断二者是否匹配。

适用于二手车交易、租车、物流承运、金融风控等场景的车辆归属初步核验。仅返回「相符 / 不符」结论，不返回车主任何隐私详情。本接口为身份核验类敏感能力，需登录并携带 API Key 调用，按次计费。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `car-owner-check` |
| 接口名称 | 车牌车主核验 |
| 接口地址 | `https://v1.apizero.cn/api/car-owner-check` |
| 请求方法 | `POST` |
| 分类 | kyc |
| 提供方 | 极数本源 |
| 计费模式 | 按次付费 |
| 单次消耗 | 0 积分 |
| 起步价 | ¥0.00 / 1000 次 |
| QPS 限制 | 5 req/s |
| 每日免费额度 | 0 次（已认证用户） |
| 匿名每日额度 | 0 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

需要 API Key（Authorization: Bearer <key>）。身份核验类敏感接口，不开放匿名访问；按次计费 ¥0.05/次，无免费额度。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `cp` | `string` | 是 | 车牌号（中文省份简称开头 + 6~7 位字母数字）；兼容别名 plate | `京A12345` |
| `m` | `string` | 是 | 车主姓名；兼容别名 name / owner | `张三` |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `Authorization` | `string` | 是 | Bearer <你的 API Key> | — |
| `Content-Type` | `string` | 否 | 请求体格式 | — |

## 5. 请求示例

> AI 提示：以下 5 种语言示例都是可运行的，只需把 `YOUR_API_KEY` 替换为用户申请的实际 Key（https://apizero.cn/account/keys）。
> 优先选择用户问题中提到的语言；未指定时默认使用 Python。

### cURL

```bash
curl -X POST "https://v1.apizero.cn/api/car-owner-check" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "cp": "京A12345",
  "m": "张三"
}'
```

### Python

```python
import requests

resp = requests.request(
    "POST",
    "https://v1.apizero.cn/api/car-owner-check",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
    "cp": "京A12345",
    "m": "张三",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())
```

### JavaScript (Node.js)

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

### Go

```go
package main

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

func main() {
	body := []byte(`{"cp":"京A12345","m":"张三"}`)
	req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/car-owner-check", 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
<?php
$payload = json_encode([
    "cp" => "京A12345",
    "m" => "张三",
], JSON_UNESCAPED_UNICODE);

$ch = curl_init("https://v1.apizero.cn/api/car-owner-check");
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. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `plate` | `string` | 车牌号（原样回显） | — |
| `owner` | `string` | 车主姓名（原样回显） | — |
| `matched` | `boolean` | 车牌与车主是否相符 | — |
| `result` | `string` | 核验结论文本 | — |

## 7. 响应示例

```json
{
  "code": 0,
  "msg": "成功",
  "data": {
    "plate": "京A12345",
    "owner": "张三",
    "matched": true,
    "result": "此车牌号与车主相符"
  },
  "request_id": "abc123"
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `4000` | `VALIDATION_ERROR` | 缺少必填参数或车牌/姓名格式错误 |
| `4015` | `KEY_REQUIRED` | 此接口需要 API Key（不开放匿名） |
| `4022` | `INSUFFICIENT` | 余额不足，请充值后再试 |
| `5020` | `UPSTREAM_ERROR` | 核验服务暂不可用 |
| `5021` | `UPSTREAM_INVALID` | 核验结果解析失败 |
| `5030` | `UPSTREAM_MISSING` | 核验服务未配置，请联系管理员 |

## 9. 变更日志

- **v1.0** (2026-07-01)
  - 首次上线。

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/car-owner-check`

Source: `https://apizero.cn/aidocs/car-owner-check/raw.md`
Last updated: 2026-07-01T12:02:00+08:00