行駛證識別
更新時間 2025-10-17 16:16:40
最近更新時間: 2025-10-17 16:16:40
分享文章
接口描述
針對行駛證主頁圖片,進行OCR檢測,返回檢測到的號牌號碼、車輛類型、所有人、住址、使用性質、品牌型號、車輛識別代號、發動機號碼、注冊日期、發證日期。
支持紙質行駛證和電子行駛證的主頁識別。
支持0度、90度、180度、270度四個方向文字的識別。
備注:接口只允許單張圖片請求,不允許圖片list。
請求方法
POST
接口要求
- 目前僅支持 base64 編碼方式請求,暫不支持 url 方式請求。一次請求僅支持一條數據。
- 圖片格式限制:目前僅支持 jpg、jpeg、png、bmp 等常見格式。
- 圖片大小限制:base64 編碼后圖片大小不超過 7 MB。
- 圖片尺寸限制:圖片像素尺寸應不小于 32x32,不大于 5000x5000。
請求URI
/v1/aiop/api/3131km7vva4g/driving-lisence/ocr/detect
請求參數
1.請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | json 格式 | application/json | |
| appkey | 是 | String | 平臺應用appkey | 562b89493b1a40e1b97ea05e50XXXXX | |
| 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 | 固定值“VehicleRegistration” | VehicleRegistration | |
| ImageData | 是 | String | 圖片 Base64 編碼數據,圖片需要使用常規 safe base64 編碼方式,不包含前綴 "data:img/jpg;base64," | _9j_4AAQSkZJRgA... |
請求代碼示例
Curl -X POST
"//ai-global.ctapi.daliqc.cn/v1/aiop/api/3131km7vva4g/driving-lisence/ocr/detect"
-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:20241109T104641Z"
-H "host:ai-global.ctapi.daliqc.cn"
--data '{"Action": "VehicleRegistration","ImageData": "_9j_4AAQSkZJRgA..."}'
返回值說明
1.請求成功返回響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| statusCode | 是 | Int | 請求響應狀態碼,返回 0 表示成功,返回錯誤代碼參考下面的錯誤代碼列表 | 0 | |
| message | 是 | String | 如果statusCode為0,返回success;如果statusCode非0,則返回對應的可讀錯誤信息 | success | |
| returnObj | 是 | Object | 返回的行駛證識別結果對象 | returnObj |
表returnObj
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| No_plate | 是 | String | 號牌號碼 | 滬AAXXX64 | |
| type | 是 | String | 車輛類型 | 小型轎車 | |
| owner | 是 | String | 所有人 | XXX | |
| address | 是 | String | 住址 | 上海市長寧區XXX路900號 | |
| use | 是 | String | 使用性質 | 非營運 | |
| model | 是 | String | 品牌型號 | XXX牌XXXXXXEV1 | |
| vin | 是 | String | 車輛識別代號 | LC0CEXXXXXXXX3856 | |
| No_engine | 是 | String | 發動機號碼 | 1A1XXXX06 | |
| date_register | 是 | String | 注冊日期 | 2024-10-25 | |
| date_issue | 是 | String | 發證日期 | 2024-10-25 |
2.請求失敗返回響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| statusCode | 是 | Int | 錯誤碼,放置API對應的錯誤碼 | 400003 | |
| message | 是 | String | 返回對應的錯誤信息 | body內容為空 | |
| details | 是 | String | 返回對應的錯誤描述 | Body請求數據為空,沒有包含內容 |
返回值示例
1.請求成功返回值示例
{
"statusCode": 0,
"message": "success",
"returnObj": {
"No_plate": "滬AAXXX64",
"type": "小型轎車",
"owner": "XX",
"address": "上海市長寧區XXX路900號",
"use": "非營運",
"model": "XXX牌XXXXXXEV1",
"vin": "LC0CEXXXXXXXX3856",
"No_engine": "1A1XXXX06",
"date_register": "2021-10-25",
"date_issue": "2021-10-25"
}
}
2.請求失敗返回值示例
{
"statusCode": 400003,
"message": "body內容為空",
"details": "Body請求數據為空,沒有包含內容"
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 表示請求成功。 |
錯誤碼說明
6 位錯誤碼。4 開頭為業務錯誤碼,5 開頭為服務錯誤碼。
| 錯誤碼 | 錯誤信息 | 錯誤描述 |
|---|---|---|
| CTAPI_10000 | API Not Found | |
| CTAPI_0009 | 無效json的body參數 | |
| 400005 | 請求體類型錯誤 | 請求體需為字典,不能為其他類型 |
| 400006 | 必傳的參數未傳 | 必須的參數(Action、ImageData)未傳 |
| 400008 | 請求體的參數字段類型錯誤 | Action、ImageData字段應該是String類型 |
| 400009 | 請求體的參數字段值為空 | Action、ImageData字段值為空字符 |
| 400010 | 請求體的參數字段值設置錯誤 | Action值設置錯誤 |
| 400011 | base64數據處理異常 | ImageData字段的base64字符串轉換字節碼異常 |
| 400012 | 文件格式不合法 | 僅支持 jpeg/png/jpg/bmp 格式 |
| 400013 | 文件大小不符合要求 | 該文件大小不符合要求,圖片要求小于7M |
| 410001 | 圖片解碼錯誤 | 字節碼解碼為圖片錯誤 |
| 410002 | 圖片尺寸不符合要求 | 分辨率長寬尺寸應不高于5000不低于32 |
| 500001 | 服務接口異常,請聯系管理員 | 需要聯系管理員處理 |
base64 編碼規則:使用常規的 safe base64 編碼方式
- python 中推薦使用
base64.urlsafe_b64encode()函數進行編碼。 - java 中推薦使用
BASE64.getUrlEncoder().encodeToString()函數進行編碼。