<!-- 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。旧版字段保持兼容，并新增 registration_authority（登记机关）、business_term（营业期限）、ocr_ms。

## 1. 基本信息

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

## 2. 认证

需要 API Key（Authorization: Bearer <key>）。登录用户每日免费额度见套餐。

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

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `input_type` | `string` | 是 | 图片传输方式：url（公网图片地址）或 base64 | `url` |
| `input_data` | `string` | 是 | 图片内容：url 时填 http/https 链接；base64 时填编码串（可含 data:image/xxx;base64, 前缀），≤10MB | `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` | 证件类型（如营业执照） | — |
| `unified_social_credit_code` | `string` | 统一社会信用代码 | — |
| `company_name` | `string` | 名称 | — |
| `company_type` | `string` | 类型 | — |
| `legal_representative` | `string` | 法定代表人 | — |
| `registered_capital` | `string` | 注册资本 | — |
| `established_date` | `string` | 成立日期（规范化 YYYY-MM-DD） | — |
| `established_time` | `string` | 成立日期原文 | — |
| `business_term` | `string` | 营业期限（若票面有） | — |
| `domicile` | `string` | 住所 | — |
| `business_scope` | `string` | 经营范围 | — |
| `registration_authority` | `string` | 登记机关 | — |
| `approval_date` | `string` | 核准/发证日期 | — |
| `website` | `string` | 公示系统网址（若识别到） | — |
| `ocr_ms` | `number` | 识别耗时（毫秒） | — |

## 7. 响应示例

```json
{
  "code": 0,
  "msg": "成功",
  "data": {
    "certificate_type": "营业执照",
    "unified_social_credit_code": "91110000MA01234567",
    "company_name": "北京示例科技有限公司",
    "company_type": "有限责任公司(自然人投资或控股)",
    "legal_representative": "张三",
    "registered_capital": "壹佰万圆人民币",
    "established_date": "2018-05-20",
    "established_time": "2018年5月20日",
    "business_term": "长期",
    "domicile": "北京市海淀区示例路1号",
    "business_scope": "一般项目：技术服务、技术开发……",
    "registration_authority": "北京市海淀区市场监督管理局",
    "approval_date": "2024-10-18",
    "website": "http://www.gsxt.gov.cn",
    "ocr_ms": 1300
  },
  "request_id": "abc123"
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `4000` | `VALIDATION_ERROR` | 缺少必填参数或图片格式错误 |
| `5020` | `UPSTREAM_ERROR` | 识别服务暂不可用 |
| `5021` | `UPSTREAM_INVALID` | 未能识别有效营业执照信息 |
| `5030` | `UPSTREAM_MISSING` | 识别服务未配置，联系管理员 |

## 9. 变更日志

- **v1.0** (2026-06-04)
  - 首次上线营业执照识别接口，支持 URL 和 base64 两种传图方式，返回 12 个结构化字段。
- **v1.1** (2026-07-10)
  - 切换本平台自建识别引擎；补充登记机关、营业期限、ocr_ms；旧 12 字段保持兼容。

---

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

Source: `https://apizero.cn/aidocs/business-license/raw.md`
Last updated: 2026-08-07T04:29:08+08:00