1. 接口描述
接口请求域名： ocr.tencentcloudapi.com 。
本接口支持驾驶证主页和副页所有字段的自动定位与识别，重点字段的识别准确度达到99%以上。
驾驶证主页：包括证号、姓名、性别、国籍、住址、出生日期、初次领证日期、准驾车型、有效期限、发证单位
驾驶证副页：包括证号、姓名、档案编号、记录。
另外，本接口还支持复印件、翻拍告警功能。同时支持识别交管12123 APP发放的电子驾驶证正页。
电子驾驶证正页：包括证号、姓名、性别、国籍、出生日期、初次领证日期、准驾车型、有效期开始时间、有效期截止时间、档案编号、状态、累积记分。
默认接口请求频率限制：10次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：DriverLicenseOCR。 |
| Version | 是 | String | 公共参数，本接口取值：2018-11-19。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表，本接口仅支持其中的: ap-beijing, ap-guangzhou, ap-hongkong, ap-shanghai 。 |
| ImageBase64 | 否 | String | 图片的 Base64 值。要求图片经Base64编码后不超过 7M，分辨率建议500*800以上，支持PNG、JPG、JPEG、BMP格式。建议卡片部分占据图片2/3以上。 图片的 ImageUrl、ImageBase64 必须提供一个，如果都提供，只使用 ImageUrl。 |
| ImageUrl | 否 | String | 图片的 Url 地址。要求图片经Base64编码后不超过 7M，分辨率建议500*800以上，支持PNG、JPG、JPEG、BMP格式。建议卡片部分占据图片2/3以上。图片下载时间不超过 3 秒。 建议图片存储于腾讯云，可保障更高的下载速度和稳定性。 示例值：https://xx/a.jpg |
| CardSide | 否 | String | FRONT 为驾驶证主页正面（有红色印章的一面）， BACK 为驾驶证副页正面（有档案编号的一面）。 DOUBLE 支持自动识别驾驶证正副页单面，和正副双面同框识别 默认值为：FRONT。 示例值：FRONT |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Name | String | 驾驶证正页姓名 示例值：李明 |
| Sex | String | 性别 示例值：男 |
| Nationality | String | 国籍 示例值：中国 |
| Address | String | 住址 示例值：上海市徐汇区田林路397号腾云大厦6F |
| DateOfBirth | String | 出生日期（YYYY-MM-DD） 示例值：1987-01-01 |
| DateOfFirstIssue | String | 初次领证日期（YYYY-MM-DD） 示例值：2011-10-01 |
| Class | String | 准驾车型 示例值：C1 |
| StartDate | String | 有效期开始时间（YYYY-MM-DD） 示例值：2011-10-01 |
| EndDate | String | 有效期截止时间（新版驾驶证返回 YYYY-MM-DD， 老版驾驶证返回有效期限 X年） 示例值：2017-10-01 |
| CardCode | String | 驾驶证正页证号 示例值：440524198701010014 |
| ArchivesCode | String | 档案编号 |
| Record | String | 记录 |
| RecognizeWarnCode | Array of Integer | Code 告警码列表和释义： -9102 复印件告警 -9103 翻拍件告警 -9104 反光告警 -9105 模糊告警 -9106 边框不完整告警 注：告警码可以同时存在多个 示例值：[-9102] |
| RecognizeWarnMsg | Array of String | 告警码说明： WARN_DRIVER_LICENSE_COPY_CARD 复印件告警 WARN_DRIVER_LICENSE_SCREENED_CARD 翻拍件告警 WARN_DRIVER_LICENSE_REFLECTION 反光告警 WARN_DRIVER_LICENSE_BLUR 模糊告警 WARN_DRIVER_LICENSE_BORDER_INCOMPLETE 边框不完整告警 注：告警信息可以同时存在多个 示例值：["WARN_DRIVER_LICENSE_COPY_CARD"] |
| IssuingAuthority | String | 发证单位 示例值：上海市公安局交通警察总队 |
| State | String | 状态（仅电子驾驶证支持返回该字段） |
| CumulativeScore | String | 累积记分（仅电子驾驶证支持返回该字段） |
| CurrentTime | String | 当前时间（仅电子驾驶证支持返回该字段） |
| GenerateTime | String | 生成时间（仅电子驾驶证支持返回该字段） |
| BackPageName | String | 驾驶证副页姓名 |
| BackPageCardCode | String | 驾驶证副页证号 |
| DriverLicenseType | String | 驾驶证类型 电子驾驶证：Electronic 普通驾驶证：Normal 示例值：Normal |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 驾驶证识别示例代码1 前往调试工具
驾驶证识别
输入示例
POST / HTTP/1.1
Host: ocr.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DriverLicenseOCR
<公共请求参数>
{
"ImageUrl": "https://xx/a.jpg",
"CardSide": "FRONT"
}输出示例
{
"Response": {
"Address": "广东省深圳市南山区腾讯大厦",
"ArchivesCode": "",
"CardCode": "440305198305101408",
"Class": "C2",
"CumulativeScore": "",
"DateOfBirth": "1983-05-10",
"DateOfFirstIssue": "2005-05-01",
"EndDate": "2025-10-01",
"IssuingAuthority": "上海市公安局交通警察总队",
"Name": "刘洋",
"Nationality": "中国",
"RecognizeWarnCode": [],
"RecognizeWarnMsg": [],
"Record": "",
"RequestId": "9b0d1ee9-8fdb-4194-be58-212bee88a7fd",
"Sex": "女",
"StartDate": "2015-10-01",
"CurrentTime": "",
"GenerateTime": "",
"State": "",
"BackPageName": "",
"BackPageCardCode": "",
"DriverLicenseType": ""
}
}示例2 驾驶证识别示例代码2 前往调试工具
驾驶证识别
输入示例
POST / HTTP/1.1
Host: ocr.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DriverLicenseOCR
<公共请求参数>
{
"ImageUrl": "https://xx/a.jpg",
"CardSide": "FRONT"
}输出示例
{
"Response": {
"Address": "上海市徐汇区田林路397号腾云大厦6F",
"ArchivesCode": "",
"CardCode": "440524198701010014",
"Class": "C1",
"CumulativeScore": "",
"DateOfBirth": "1987-01-01",
"DateOfFirstIssue": "2011-10-01",
"EndDate": "2017-10-01",
"IssuingAuthority": "上海市公安局交通警察总队",
"Name": "李明",
"Nationality": "中国",
"RecognizeWarnCode": [
-9102
],
"RecognizeWarnMsg": [
"WARN_DRIVER_LICENSE_COPY_CARD"
],
"Record": "",
"RequestId": "c5ceedaa-cb6f-4210-af49-0a5dee461259",
"Sex": "男",
"StartDate": "2011-10-01",
"CurrentTime": "",
"GenerateTime": "",
"State": "",
"BackPageName": "",
"BackPageCardCode": "",
"DriverLicenseType": ""
}
}示例3 驾驶证识别示例代码3 前往调试工具
驾驶证反面
输入示例
POST / HTTP/1.1
Host: ocr.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DriverLicenseOCR
<公共请求参数>
{
"ImageUrl": "https://xx/a.jpg",
"CardSide": "BACK"
}输出示例
{
"Response": {
"Address": "",
"ArchivesCode": "130123421234",
"CardCode": "130721234511112345",
"Class": "",
"CumulativeScore": "",
"DateOfBirth": "",
"DateOfFirstIssue": "",
"EndDate": "",
"IssuingAuthority": "",
"Name": "李明",
"Nationality": "",
"RecognizeWarnCode": [],
"RecognizeWarnMsg": [],
"Record": "",
"RequestId": "03023a0a-cf96-4baa-8cd8-34ba9d32f3db",
"Sex": "",
"StartDate": "",
"CurrentTime": "",
"GenerateTime": "",
"State": "",
"BackPageName": "",
"BackPageCardCode": "",
"DriverLicenseType": ""
}
}示例4 驾驶证识别示例代码4 前往调试工具
电子驾驶证识别
输入示例
POST / HTTP/1.1
Host: ocr.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DriverLicenseOCR
<公共请求参数>
{
"ImageUrl": "https://xx/a.jpg"
}输出示例
{
"Response": {
"Address": "",
"ArchivesCode": "321123405123",
"CardCode": "321281298512340017",
"Class": "C1",
"CumulativeScore": "1分",
"DateOfBirth": "1995-11-22",
"DateOfFirstIssue": "2012-02-19",
"EndDate": "2030-07-19",
"IssuingAuthority": "",
"Name": "冯妙",
"Nationality": "中国",
"RecognizeWarnCode": [],
"RecognizeWarnMsg": [],
"Record": "",
"RequestId": "4b67dd01-c0ba-43c0-b899-e1088fa314fe",
"Sex": "女",
"StartDate": "2020-01-20",
"CurrentTime": "",
"GenerateTime": "",
"State": "未处理",
"BackPageName": "",
"BackPageCardCode": "",
"DriverLicenseType": ""
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.DownLoadError | 文件下载失败。 |
| FailedOperation.EmptyImageError | 图片内容为空。 |
| FailedOperation.ImageBlur | 图片模糊。 |
| FailedOperation.ImageDecodeFailed | 图片解码失败。 |
| FailedOperation.ImageNoText | 图片中未检测到文本。 |
| FailedOperation.ImageSizeTooLarge | 图片尺寸过大，请参考输入参数中关于图片大小限制的说明。 |
| FailedOperation.LicenseCardSideError | 入参CardSide错误，与实际上传的卡证正副页类型不符 |
| FailedOperation.LicenseMultiCardError | 图片中存在两张及以上同面卡证，请上传卡证单面图片或一正一反双面图片 |
| FailedOperation.NoDriverLicenseError | 上传的图片非驾驶证 |
| FailedOperation.OcrFailed | OCR识别失败。 |
| FailedOperation.UnKnowError | 未知错误。 |
| FailedOperation.UnOpenError | 服务未开通。 |
| InvalidParameter.EngineImageDecodeFailed | 图片解码失败。 |
| InvalidParameterValue.InvalidParameterValueLimit | 参数值错误。 |
| LimitExceeded.TooLargeFileError | 文件内容太大。 |
| ResourceUnavailable.InArrears | 账号已欠费。 |
| ResourceUnavailable.ResourcePackageRunOut | 账号资源包耗尽。 |
| ResourcesSoldOut.ChargeStatusException | 计费状态异常。 |
