<!-- 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 -->

# 营业执照识别

> 上传营业执照图片（URL 或 base64），自动识别证件字段，包括统一社会信用代码、公司名称、法人、注册资本、经营范围等共 12 个关键字段信息。

适用于企业资质核验、合规审查、供应商管理、电商开店审核等场景。支持 JPG / PNG，文件大小不超过 10 MB，建议图片清晰、完整、无遮挡。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `business-license` |
| 接口名称 | 营业执照识别 |
| 接口地址 | `https://v1.apizero.cn/api/business-license` |
| 请求方法 | `POST` |
| 分类 | ocrdata |
| 提供方 | 极数本源 |
| 计费模式 | 免费试用 |
| 单次消耗 | 0 积分 |
| 起步价 | — |
| QPS 限制 | 2 req/s |
| 每日免费额度 | 20 次（已认证用户） |
| 匿名每日额度 | 0 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

需要 API Key（Authorization: Bearer <key>）。登录用户每日 20 次免费。

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

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `input_type` | `string` | 是 | 图片传入方式 | `url` |
| `input_data` | `string` | 是 | 图片 URL 或 base64 编码字符串（jpg/png，base64 最大 10 MB） | `https://example.com/business-license.jpg` |

## 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/business-license" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input_type": "url",
  "input_data": "https://example.com/business-license.jpg"
}'
```

### Python

```python
import requests

resp = requests.request(
    "POST",
    "https://v1.apizero.cn/api/business-license",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
    "input_type": "url",
    "input_data": "https://example.com/business-license.jpg",
},
    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/business-license", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input_type": "url",
    "input_data": "https://example.com/business-license.jpg"
  }),
});
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(`{"input_type":"url","input_data":"https://example.com/business-license.jpg"}`)
	req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/business-license", 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([
    "input_type" => "url",
    "input_data" => "https://example.com/business-license.jpg",
], JSON_UNESCAPED_UNICODE);

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

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `certificate_type` | `string\|null` | 证书类型 | — |
| `unified_social_credit_code` | `string\|null` | 统一社会信用代码（18 位） | — |
| `company_name` | `string\|null` | 公司名称 | — |
| `company_type` | `string\|null` | 公司类型（如有限责任公司） | — |
| `domicile` | `string\|null` | 住所/注册地址 | — |
| `legal_representative` | `string\|null` | 法定代表人 | — |
| `registered_capital` | `string\|null` | 注册资本 | — |
| `established_time` | `string\|null` | 成立日期 | — |
| `established_date` | `string\|null` | 营业期限 | — |
| `business_scope` | `string\|null` | 经营范围 | — |
| `website` | `string\|null` | 企业信用信息公示系统网址 | — |
| `approval_date` | `string\|null` | 核准日期 | — |

## 7. 响应示例

```json
{
  "code": 0,
  "msg": "成功",
  "data": {
    "certificate_type": "营业执照",
    "unified_social_credit_code": "91310000XXXXXXXXXX",
    "company_name": "某某科技有限公司",
    "company_type": "有限责任公司（自然人独资）",
    "domicile": "上海市浦东新区某某路123号",
    "legal_representative": "张三",
    "registered_capital": "100万人民币",
    "established_time": "2015-06-01",
    "established_date": "2015-06-01至无固定期限",
    "business_scope": "软件开发；信息技术咨询服务",
    "website": "http://www.gsxt.gov.cn",
    "approval_date": "2025-01-10"
  },
  "request_id": "req_abc123"
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `4000` | `VALIDATION_ERROR` | 参数缺失或格式错误，如 input_type 不是 url/base64，或 input_data 为空 |
| `5020` | `UPSTREAM_ERROR` | 上游 OCR 服务不可用，请稍后重试 |
| `5021` | `UPSTREAM_INVALID` | 图片无法识别，请确认为清晰的营业执照图片 |
| `5030` | `UPSTREAM_MISSING` | OCR 服务未配置或未开通，请联系管理员 |

## 9. 变更日志

- **v1.0** (2026-06-04)
  - 首次上线营业执照识别接口，支持 URL 和 base64 两种传图方式，返回 12 个结构化字段。

---

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

Source: `https://apizero.cn/aidocs/business-license/raw.md`
Last updated: 2026-06-04T17:11:02+08:00