駕駛證識別
更新時(shi)間 2025-09-24 09:59:13
最近更(geng)新時(shi)間(jian): 2025-09-24 09:59:13
分享文章
接口描述
針對駕(jia)駛證主(zhu)頁圖(tu)片(pian),進行OCR檢(jian)測,返回檢(jian)測到的駕(jia)駛證號、姓名(ming)、性別、國籍、住(zhu)址、出生日期、初次領證日期、準駕(jia)車型、有效期限(xian)。
駕駛證(zheng)識別(bie)(bie)只支持(chi)主(zhu)頁識別(bie)(bie),不(bu)支持(chi)電子駕駛證(zheng)的(de)識別(bie)(bie)。
支(zhi)持0度、90度、180度、270度四個方向文字(zi)的(de)識(shi)別(bie)。
備注(zhu):接口只允(yun)許單張圖(tu)(tu)片請求,不允(yun)許圖(tu)(tu)片list。
請求方法
POST
接口要求
- 目前僅支持 base64 編碼方式請求,一次請求僅支持一條數據。
- 圖片格式限制:目前僅支持 jpg、jpeg、png、bmp 格式。
- 圖片大小限制:base64 編碼后,圖片大小不超過 7 MB。
- 圖片尺寸限制:圖片像素尺寸應不小于 32x32,不大于 5000x5000。
請求URI
/v1/aiop/api/3131mkjqbqck/driver-lisence/ocr/detect
請求參數
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 | 算法名稱,固定值“DriversLicense” | DriversLicense | |
| ImageData | 是 | String | 圖片 Base64 編碼數據,圖片需要使用常規 safe base64 編碼方式,不包含前綴 "data:img/jpg;base64," | _9j_4AAQSkZJRgA... |
請求代碼示例
Curl -X POST
"//ai-global.ctapi.daliqc.cn/v1/aiop/api/3131mkjqbqck/driver-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:20211109T104641Z"
-H "host:ai-global.ctapi.daliqc.cn"
--data '{"Action": "DriversLicense","ImageData": "_9j_4AAQSkZJRgA..."}'
返回值說明
1.請求成功返回響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| statusCode | 是 | Int | 請求響應狀態碼,返回 0 表示成功,返回錯誤代碼參考下面的錯誤代碼列表 | 0 | |
| message | 是 | String | 如果statusCode為0,返回success;如果statusCode非0,則返回對應的可讀錯誤信息 | success | |
| returnObj | 是 | Object | 返回的駕駛證識別結果對象 | returnObj |
表returnObj
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| No | 是 | String | 身份證號 | 3101151992XX24XXXX | |
| name | 是 | String | 姓名 | 劉XX | |
| sex | 是 | String | 性別 | 男 | |
| nation | 是 | String | 國籍 | 中國 | |
| address | 是 | String | 住址 | 上海市長寧區XXX路900號 | |
| date_birth | 是 | String | 出生日期 | 1992-12-24 | |
| date_first | 是 | String | 初次領證日期 | 2020-10-25 | |
| class | 是 | String | 準駕車型 | C1 | |
| period | 是 | String | 有效期限 | 2020-10-25至2026-10-25 |
2.請求失敗返回響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| statusCode | 是 | Int | 錯誤碼,放置API對應的錯誤碼 | 400003 | |
| message | 是 | String | 返回對應的錯誤信息 | body內容為空 | |
| details | 是 | String | 返回對應的錯誤描述 | Body請求數據為空,沒有包含內容 |
返回值示例
1.請求成功返回值示例
{
"statusCode": 0,
"message": "success",
"returnObj": {
"No": "3101151992XX24XXXX",
"name": "劉XX",
"sex": "男",
"nation": "中國",
"address": "上海市長寧區XXX路900號",
"date_birth": "1992-12-24",
"date_first": "2020-10-25",
"class": "C1",
"period": "2020-10-25至2026-10-25"
}
}
2.請求失敗返回值示例
{
"statusCode": 400003,
"message": "body內容為空",
"details": "Body請求數據為空,沒有包含內容"
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 200 | 表示請求成功。 |
錯誤碼說明
6 位錯誤(wu)碼。4 開頭為業務錯誤(wu)碼,5 開頭為服務錯誤(wu)碼。
| 錯誤碼 | 錯誤信息 | 錯誤描述 |
|---|---|---|
| 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()函數進行編碼。