/ocr/vehicle_license

优质

小牛编辑

169浏览

2023-12-01

1.接口描述

该 API 用于识别静态行驶证图像上的文字信息。

图片要求：
1. 格式为 JPG（JPEG），BMP，PNG，GIF，TIF
2. 宽和高大于 8px，小于等于 4000px
3. 小于等于 5 MB

请求方式

POST

请求 URL

https://cloudapi.linkface.cn/ocr/vehicle_license

2.请求参数

字段	类型	必需	描述
api_id	string	是	API 账户
api_secret	string	是	API 密钥
file	file	见下方注释	需上传的图片文件，上传本地图片进行检测时选取此参数
url	string	见下方注释	图片网络地址，采用抓取网络图片方式时需选取此参数
image_id	string	见下方注释	图片的id，在云端上传过图片可采用此参数

请求参数 file,url与 image_id 必须选择其中的一个。
url 中含有不少特殊字符，若将 URL 放入 Query String 中则需要对这些字符进行转义，所有中文和特殊字符必需以UTF-8编码转义。目前支持 http/https 等协议的网络地址。下载限时 5s，超时后仍未下载完成则属于失败。参数 file 需把图片文件的内容以 multipart/form-data 的形式放到 POST 消息体中。

3.返回参数

字段	类型	说明
request_id	string	本次请求的id
status	string	状态，正常为 `OK`，其他值表示失败，详见错误码
ocr_status	string	OCR识别结果，正常情况是`OK`
image_id	string	使用file、url方式返回的图片的id
result	array of object	行驶证文字信息， `ocr_status`为`OK`时才返回，详见`result`数组中字段的结构

result 数组中字段的结构：

字段	类型	说明
plate_no	string	号牌号码
vehicle_type	string	车辆类型
owner	string	所有人
address	string	住址
model	string	品牌型号
vin	string	车辆识别代号
engine_no	string	发动机号码
register_date	string	注册日期
issue_date	string	发证日期
use_character	string	使用性质

行驶证识别结果示例

{
    "request_id": "TID587cc3fdc4084b039308bfc2feb67c44",
    "status": "OK",
    "ocr_status": "OK",
    "image_id": "2e93d7a7ff6548ec884e23edcc199ed1",
    "result": {
        "plate_no": "桂N30***",
        "vehicle_type": "微型自卸货车",
        "owner": "袁**",
        "address": "广西******",
        "model": "红岩牌CQ3254SMHG384",
        "vin": "LZFF25M4X8D00****",
        "engine_no": "0812115****",
        "register_date": "2010-03-23",
        "issue_date": "2010-03-23",
        "use_character": "货运"
    }
}

4.错误码

状态码	`status` 字段	说明
`400`	ENCODING_ERROR	参数非UTF-8编码
`400`	DOWNLOAD_TIMEOUT	网络地址图片获取超时
`400`	IMAGE_ID_NOT_EXIST	图片不存在
`400`	CORRUPT_IMAGE	文件不是图片文件或已经损坏
`400`	DOWNLOAD_ERROR	网络地址图片获取失败
`400`	IMAGE_FILE_SIZE_TOO_BIG	图片体积过大
`400`	INVALID_IMAGE_FORMAT_OR_SIZE	图片大小或格式不符合要求
`400`	INVALID_ARGUMENT	请求参数错误，具体原因见 `reason` 字段内容
`400`	INVALID_VEHICLE_LICENSE	行驶证图片识别错误
`401`	UNAUTHORIZED	账号或密钥错误
`401`	KEY_EXPIRED	账号过期，具体情况见 `reason` 字段内容
`403`	RATE_LIMIT_EXCEEDED	调用频率超出限额
`403`	NO_PERMISSION	无调用权限
`403`	OUT_OF_QUOTA	调用次数超出限额
`404`	NOT_FOUND	请求路径错误
`500`	OCR_SERVER_ERROR	识别服务器异常
`500`	INTERNAL_ERROR	服务器内部错误

输出样例

{
  "status": "INVALID_ARGUMENT",
  "reason": "must specify 'image_id', 'file' or 'url' argument",
  "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}

5.输入示例

cURL 样例

curl -X POST "https://cloudapi.linkface.cn/ocr/vehicle_license?api_id=ID&api_secret=SECRET" \
  -F file=@/PATH/TO/IMAGE

HTTPie 样例

http -f POST "https://cloudapi.linkface.cn/ocr/vehicle_license?api_id=ID&api_secret=SECRET" \
  file@/PATH/TO/IMAGE

/ocr/vehicle_license

1.接口描述

请求方式

请求 URL

2.请求参数

3.返回参数

行驶证识别结果示例

4.错误码

输出样例

5.输入示例

cURL 样例

HTTPie 样例