營業執照識別
更新(xin)時間 2025-08-15 15:23:47
最近更新時間: 2025-08-15 15:23:47
分享文章
接口描述
針對營(ying)業執照圖片,進行OCR檢測,返回檢測到的統一社會(hui)信用代碼,注(zhu)冊號,名稱,類型,住所,法定代表(biao)人,注(zhu)冊資(zi)金(jin),成立日期,營(ying)業期限,實收資(zi)本。
請求方法
POST
接口要求
- 圖片格式限制:圖片格式支持 png、jpg、jpeg、bmp格式
- 圖片大小限制:單張圖片大小不超過 7MB
- 圖片尺寸限制:圖片像素尺寸應不小于 32x32,不大于 5000x5000
URI
/v1/aiop/api/2k8jo3ghhjwg/businesslicense/ocr/v1/BusinessLicense.json
請求參數
1.請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | json格式 | application/json | |
| appkey | 是 | String | 平臺應用appkey | 562b89493b1a40e1b97ea05e50dd8170 | |
| ctyun-eop-request-id | 是 | String | 用戶請求 id,由用戶構造,用戶可以通過 uuid 等方法自行生成唯一字符串,用于日志請求追蹤。 詳見文檔:Python3調用示例 |
33dfa732-b27b-464f-b15a-21ed6845afd5 | |
| eop-date | 是 | String | 請求時間,由用戶構造,形如 yyyymmddTHHMMSSZ。 詳見文檔:Python3調用示例 |
20211221T163014Z | |
| host | 是 | String | 終端節點域名,固定字段 | ai-global.ctapi.daliqc.cn | |
| Eop-Authorization | 是 | String | 由天翼云官網 accessKey 和 securityKey 經簽名后生成,參與簽名生成的字段包括天翼云官網 accessKey 、securityKey、平臺應用的appkey(非必須),用戶請求id(非必須),請求時間,終端節點域名(非必須)以及請求體內容。 簽名邏輯詳見文檔:認證鑒權和Python3調用示例 |
2.請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Action | 是 | String | 請求參數放置于http body中,action代表需要請求的具體算法,只能為"BusinessCardOCR" | BusinessCardOCR | |
| ImageData | 是 | String | 一張圖像Base64編碼數據string。圖片需要使用常規safe base64編碼方式,不包含前綴"data:img/jpg;base64," |
請求代碼示例
Curl -X POST "//ai-global.ctapi.daliqc.cn/v1/aiop/api/2k8jo3ghhjwg/businesslicense/ocr/v1/BusinessLicense.json"
-H "Content-Type: application/json"
-H "ctyun-eop-request-id:33dfa732-b27b-464f-b15a-21ed6845afd5"
-H "appkey:XXX"
-H "Eop-Authorization:XXX"
-H "eop-date:20211109T104641Z"
-H "host:ai-global.ctapi.daliqc.cn"
--data '{"Action": "BusinessCardOCR","ImageData": "9j_4AAQSkZJRgABAQAAAQABAAD_4QAwRXhpZgAATU0AKgAAA..."}'
返回值說明
1.請求成功返回響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| statusCode | 是 | Int | 返回狀態,返回0表示成功,返回錯誤代碼參考下面的錯誤代碼列表 | 0 | |
| message | 是 | String | 如果statusCode為0,返回success;如果statusCode非0,則返回對應的可讀錯誤信息 | success | |
| returnObj | 是 | Object | 識別的結果字典,字典內包營業執照的整體判斷信息以及統一社會信用代碼、名稱、住所等詳細鍵值對信息 | returnObj |
表returnObj
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| license_type | 是 | String | 營業執照的整體判斷信息,'Business License'表示圖片是營業執照,'Not Business License'表示圖片不是營業執照 | Business License | |
| detail | 是 | Object | 返回結果鍵值集合,包含統一社會信用代碼、名稱、住所等信息 | - | detail |
表detail
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| union_id | 否 | String | 統一社會信用代碼 | - | |
| regist_no | 否 | String | 注冊號,三合一之前為注冊號 | - | |
| name | 否 | String | 名稱 | - | |
| type | 否 | String | 類型 | - | |
| addr | 否 | String | 住所 | - | |
| legal_rep | 否 | String | 法定代表人 | - | |
| regist_captial | 否 | String | 注冊資金 | - | |
| establish_date | 否 | String | 成立日期 | - | |
| operation_period | 否 | String | 營業期限 | - | |
| real_captial | 否 | String | 實收資本(檢測到雙列營業執照返回此項,單列營業執照無此項信息) | - | |
| composing_form | 否 | String | 組成形式 | - | |
| serial_number | 否 | String | 編號 | - | |
| business_scope | 否 | String | 經營范圍 | - | |
| national_emblem | 否 | Boolean | 是否有國徽。false為沒有,true為有 | - | |
| qr_code | 否 | Boolean | 是否有二維碼。false為沒有,true為有 | - | |
| seal | 否 | Boolean | 是否有印章。false為沒有,true為有 | - | |
| is_duplication | 否 | Boolean | 是否為副本。false為非副本,true為副本 | - |
2.請求失敗返回響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| statusCode | 是 | Int | 錯誤碼,參見本文檔錯誤碼說明部分 | 400010 | |
| message | 是 | String | 返回對應的錯誤信息 | Action值設置錯誤 | |
| details | 是 | String | 返回對應的錯誤描述 | Action值設置錯誤 | |
| error | 是 | String | 返回對應的錯誤碼 | AI_OP_400010 |
返回值示例
1.請求成功返回值示例
{
"statusCode": 0,
"message": "success",
"returnObj": {
"license_type": "Business License",
"detail": {
"union_id": "",
"regist_no": "32050XXXXXX8749",
"name": "蘇州市XXXX有限公司",
"type": "有限公司(自然人控股)",
"addr": "蘇州市相城區XXXXXXXXX",
"legal_rep": "潘X",
"regist_captial": "200萬元人民幣",
"establish_date": "2005年6月9日",
"business_scope": "一般經營項目XXXXXXXXX",
"national_emblem": true,
"qr_code": true,
"seal": true,
"is_duplication": true,
"operation_period": "2005年06月09日至2015年06月08日",
"real_captial": "200萬元人民幣",
"composing_form": "",
"serial_number": ""
}
}
}
2.請求失敗返回值示例
{
"statusCode": 400010,
"message": "Action值設置錯誤",
"details": "Action值設置錯誤",
"error":"AI_OP_400010"
}
狀態碼
| http狀態碼 | 描述 |
|---|---|
| 200 | 表示請求成功 |
錯誤碼說明
6 位錯誤碼。4 開頭為業務錯誤碼,5 開頭為服務錯誤碼。全局請求返回錯誤碼請參考章節API概覽?>狀態碼
| 錯誤碼 | 錯誤信息 | 錯誤描述 |
|---|---|---|
| CTAPI_10000 | API Not Found | |
| CTAPI_0009 | 無效json的body參數 | |
| AI_OP_400005 | 請求體類型錯誤 | 請求體需為字典,不能為其他類型 |
| AI_OP_400006 | 必傳的參數未傳 | 必須的參數('Action'、'ImageData')未傳 |
| AI_OP_400008 | 請求體的字段類型錯誤 | Action字段值為string類型 ImageData 字段值為string類型 |
| AI_OP_400009 | 請求體的參數字段值為空 | Action字段值為空字符 ImageData 字段值為空字符 |
| AI_OP_400010 | 請求體的參數字段值設置錯誤 | Action 值設置錯誤 |
| AI_OP_400011 | base64 數據處理異常 | ImageData 字段的 base64 字符串轉換字節碼異常 |
| AI_OP_400012 | 請求文件格式不合法 | 僅支持 jpeg/png/jpg/bmp 格式 |
| AI_OP_400013 | 圖片文件大小不符合要求 | 該文件大小不符合要求,靜態圖片要求小于7M |
| AI_OP_410001 | 圖片解碼錯誤 | 字節碼解碼為圖片錯誤 |
| AI_OP_410002 | 圖片尺寸不符合要求 | 分辨率長寬尺寸應不高于5000不低于32 |
| AI_OP_500001 | 服務接口異常,請聯系管理員 | 需要聯系管理員處理 |
base64 編碼規則:使用常規的 safe base64 編碼方式
- python 中推薦使用
base64.urlsafe_b64encode()函數進行編碼 - java 中推薦使用
BASE64.getUrlEncoder().encodeToString()函數進行編碼