# Generated by ShowAPI OpenAPI generator # source: market/1333 # generated-at: 2026-09-09T05:36:17.348Z openapi: 3.0.3 info: title: 车辆证件类OCR识别 description: OCR类图像识别，支持驾驶证、行驶证、车牌、车款、VIN码等识别，提取图片中的关键字段信息并结构化输出。适用于车主身份认证、ETC出行、违章识别、停车场车辆进出管理等场景。 termsOfService: https://www.showapi.com/helpcenter/view#/4019/2 version: 1.0.0 servers: - url: https://route.showapi.com paths: /1333-8: x-pointCode: 8 x-mode: mapping x-read-timeout: 60 x-connect-timeout: 20 post: summary: 车型识别 description: 针对轿车图片（需base64编码，长宽比适宜），识别并输出车辆的品牌、型号及生产年份。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: result: type: array items: type: object properties: confidence_level: type: number description: 置信度(0-1) name: type: string description: 车系 year: type: string description: 年款 description: 识别结果集合 没有识别到时可能返回空集合 ret_code: type: number description: |- ret_code = 0 无异常 10 参数错误 20 文件格式错误 30 操作失败,请勿重复提交 40 文件下载失败 50 文件内容过大 60 图片解析失败 70 识别失败 80 服务超时 90 未知错误(error_code) remark: type: string description: 错误信息 description: 业务返回体 operationId: 1333_8_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: img_base64: type: string minLength: 0 maxLength: 10000000 description: 图片的base64编码，注意转码后得到的字符串一般不用进行urlencode，也就是说上传的base64字符串中含有+和/字符。png格式图片base64一般以iVBO开头，jpg图片的base64一般以/9j/开头，在此之前的修饰字符都是多余的，上传时必须去除。 img_url: type: string description: 要识别图片的URL，与img_base64参数二选一作为入参方式，建议图片大小不超过2M，支持jpg jpeg png格式图片 /1333-7: x-pointCode: 7 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: OCR车牌识别V2 description: 可识别图像中车牌信息，输出位置坐标、号码及可信度。支持中国大陆蓝牌、黄牌（单双行）、绿牌、大型新能源、领使馆牌、警牌、武警牌（单双行）、军牌（单双行）、港澳出入境牌、农用牌、民航牌。图片需小于4M，短边像素大于256，支持PNG、JPG、JPEG、BMP格式。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: confidence_level: type: string description: 可信度级别 ret_code: type: number description: |- 0 成功 10 文件下载失败 20 图片解析失败 30 OCR识别失败 40 参数错误 50 文件内容过大 60 文件格式错误 70 操作失败,请勿重复提交 80 服务超时 90 未知错误() range: type: array items: type: object properties: y: type: number description: 该点距离图片顶部的像素 x: type: number description: 该点距离图片左侧的像素 description: 识别内容所在区域,用四个点来表示 car_no: type: string description: 车牌 description: 业务返回体 operationId: 1333_7_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: img_base64: type: string minLength: 0 maxLength: 10000000 description: |- 图片base64字符串 img_base64和img_url 二选一，同时存在以base64为主 img_url: type: string description: |- 图片url img_base64和img_url 二选一，同时存在以base64为主 /1333-6: x-pointCode: 6 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: vin码识别 description: 本服务支持识别VIN码（车辆识别号码）。图片大小建议不超过4M，短边像素不低于256，支持PNG、JPG、JPEG、BMP格式。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: |- 0 成功 10 文件下载失败 20 图片解析失败 30 OCR识别失败 40 参数错误 50 文件内容过大 60 文件格式错误 70 操作失败,请勿重复提交 80 服务超时 90 未知错误() vin_code: type: string description: 检测到的车辆 VIN 码。 description: 业务返回体 operationId: 1333_6_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: img_base64: type: string minLength: 0 maxLength: 10000000 description: |- 图片base64字符串 img_base64和img_url 二选一，同时存在以base64为主 img_url: type: string description: |- 图片url img_base64和img_url 二选一，同时存在以base64为主 /1333-5: x-pointCode: 5 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 行驶证识别 description: 识别行驶证主页及副页，获取号牌号码、车辆类型、所有人、品牌型号、车辆识别代码、发动机号码、核定载人数、质量、尺寸、检验记录等信息。支持PNG、JPG、JPEG、BMP格式，图片小于4M，短边像素大于256。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: |- 0 无异常 10 参数错误 20 文件格式错误 30 操作失败,请勿重复提交 40 文件下载失败 50 文件内容过大 60 图片解析失败 70 OCR识别失败 80 服务超时 90 未知错误 back_result: type: object properties: car_size: type: string description: 车辆尺寸 traction_weight: type: string description: 准牵引总质量 insp_record: type: string description: 检验记录 unload_weight: type: string description: 整备质量 total_mass: type: string description: 总质量 file_no: type: string description: 档案编号 approved_passenger_num: type: string description: 核载人数 approved_weirht: type: string description: 核定载重量 car_no: type: string description: 号牌号码 description: 行驶证副页 front_result: type: object properties: vehicle_type: type: string description: 车辆类型 register_date: type: string description: 注册日期，格式：YYYYMMDD。 eng_num: type: string description: 发动机号码 vin_code: type: string description: 车辆识别代号 car_model: type: string description: 品牌型号 owner: type: string description: 所有人名称 use_type: type: string description: 使用性质 issue_date: type: string description: 发证日期，格式：YYYYMMDD addr: type: string description: 地址 car_no: type: string description: 车牌号码 issue_unit: type: string description: 发证单位 description: 行驶证首页 description: 业务返回体 operationId: 1333_5_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: img_base64: type: string minLength: 0 maxLength: 10000000 description: |- 图片base64字符串 img_base64和img_url 二选一，同时存在以base64为主 img_url: type: string description: |- 图片url img_base64和img_url 二选一，同时存在以base64为主 side: type: string description: |- 1：正面 2：背面 /1333-4: x-pointCode: 4 x-mode: mapping x-read-timeout: 5 x-connect-timeout: 5 post: summary: 驾驶证识别 description: 可识别机动车驾驶证正页及副页的结构化信息，涵盖证号、姓名、性别、国籍、住址、出生日期、初次领证日期、准驾车型、有效期限、发证单位、档案编号等字段。图片需小于4M，短边像素大于256，支持PNG、JPG、JPEG、BMP格式。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: |- 0 成功 10 文件下载失败 20 图片解析失败 30 OCR识别失败 40 参数错误 50 文件内容过大 60 文件格式错误 70 操作失败,请勿重复提交 80 服务超时 90 未知错误() back_result: type: object properties: archive_code: type: string description: 档案编号 record: type: string description: 记录 name: type: string description: 姓名 card_no: type: string description: 证号 description: 驾驶证副页 "front_result:": type: object properties: license_num: type: string description: 证号 sex: type: string description: 性别 end_date: type: string description: 驾驶证有效期时长或有效期截止日期。 格式：YYYYMMDD birth_date: type: string description: 出生日期 vehicle_type: type: string description: 准驾车型 issue_unit: type: string description: 发证单位 name: type: string description: 姓名 addr: type: string description: 地址 issue_date: type: string description: 初次发证日期。格式：YYYYMMDD， start_date: type: string description: "驾驶证有效期开始时间，格式：YYYYMMDD " description: 驾驶证首页 description: 业务返回体 operationId: 1333_4_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: img_base64: type: string minLength: 0 maxLength: 10000000 description: |- 图片base64字符串 img_base64和img_url 二选一，同时存在以base64为主 img_url: type: string description: |- 图片url img_base64和img_url 二选一，同时存在以base64为主 side: type: string description: |- 1：正面 2：背面 /1333-3: x-pointCode: 3 x-mode: mapping x-read-timeout: 35 x-connect-timeout: 35 post: summary: OCR车牌识别V1(文件上传) description: 本功能可识别上传图像中的车牌信息，输出车牌位置坐标、号码、颜色、可信度、亮度评估值、车辆类型及移动方向共7项关键信息。建议图片大小控制在1MB以内，以提升识别效率与准确性。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: string description: 接口调用是否成功,0为成功,其他为失败 flag: type: string description: 业务调用是否成功 msg: type: string description: 提示信息 color: type: string description: 车牌颜色 light: type: string description: 亮度评估值 num: type: string description: 请填写参数描述 confidence: type: string description: 识别的可信度 position: type: string description: 车牌在整张图中的像素位置,用left\right\top\bottom表示,对应左\右\上\下 type: type: string description: 车辆类型 move_direction: type: string description: 移动方向的判断 description: 业务返回体 operationId: 1333_3_POST parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: imgData: type: string format: binary description: 上传的文件,图片的大小控制在1MB以内,太大会影响识别的效率和准确率 required: - imgData /1333-1: x-pointCode: 1 x-mode: mapping x-read-timeout: 40 x-connect-timeout: 35 post: summary: OCR车牌识别V1 description: 识别出图像中车牌信息，输出车牌位置坐标、车牌号码、车牌颜色、识别可信度、亮度评估值、车辆类型、移动方向，共7个关键信息。图片大小建议控制在1MB以内，以保证识别效率与准确率。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: string description: 接口调用是否成功,0为成功,其他为失败 flag: type: string description: 业务调用是否成功 msg: type: string description: 提示信息 color: type: string description: 车牌颜色 light: type: string description: 亮度评估值 num: type: string description: 请填写参数描述 confidence: type: string description: 识别的可信度 position: type: string description: 车牌在整张图中的像素位置,用left\right\top\bottom表示,对应左\右\上\下 type: type: string description: 车辆类型 move_direction: type: string description: 移动方向的判断 description: 业务返回体 operationId: 1333_1_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: imgData: type: string minLength: 10 maxLength: 10000000 description: 车牌图片的base64信息,图片的大小控制在1MB以内,太大会影响识别的效率和准确率 required: - imgData components: securitySchemes: AppKeyAuth: type: apiKey in: query name: appKey description: 从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp schemas: ShowapiResEnvelope: type: object description: ShowAPI 统一返回包裹（业务数据位于 showapi_res_body） properties: showapi_res_code: type: integer description: API 返回的状态码 showapi_res_error: type: string description: API 返回的错误信息 showapi_res_id: type: string description: API 请求的唯一标识 showapi_fee_num: type: integer description: API 调用计费次数 security: - AppKeyAuth: [] externalDocs: url: https://www.showapi.com/apiGateway/view/1333?tab=book x-apiCode: "1333" x-is-own: false x-is-op: false