# 票证识别智能识别图片上的多张票证（票据、证件或其他文字载体），并返回识别的结构化结果。接口以列表形式返回图片上要识别票证的位置坐标、结构化识别的内容以及对应的类别。 ## 请求格式说明 ** 调试工具：** 在线调试

请求方式：POST (HTTPS)

请求地址：

https://open.welink.huaweicloud.com/api/aiservice/v1/ocr/auto-classification

认证方式： access_token，请参考获取access_token

请求头部：

Content-Type: application/json    
x-wlk-Authorization: access_token

请求参数

{ 
    "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
}

请求参数说明

参数	必填	参数类型	说明
image	是	String	图像数据，base64编码，要求base64编码后大小不超过10M。图片最小边不小于15像素，最长边不超过8000像素。支持JPG/PNG/BMP/TIFF格式。
typeList	否	Array [String]	可以指定要识别的票证，指定后不出现在此List的票证不识别。不指定时默认返回所有支持类别票证的识别信息。

支持票证类型

票证类型	参数值
增值税发票	vat_invoice
出租车票	taxi_invoice
飞机行程单	flight_itinerary
机动车销售统一发票	mvs_invoice
身份证头像面	id_card_portrait_side
驾驶证主页	driver_license_front
行驶证主页	vehicle_license_front
道路运输证	transportation_license
定额发票	quota_invoice
火车票	train_ticket
车辆通行费发票	toll_invoice
护照	passport
身份证国徽面	id_card_emblem_side
驾驶证副页	driver_license_back
行驶证副页	vehicle_license_back
银行卡	bankcard

请求示例

 curl -X POST \
  'https://open.welink.huaweicloud.com/api/aiservice/v1/ocr/auto-classification' \
  -H 'Accept-Charset: UTF-8' \
  -H 'Content-Type: application/json' \
  -H 'x-wlk-Authorization: access_token' \
  -d '{"image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."}'

响应格式说明

返回结果 正常返回结果

{
    "code": "0",
    "data": {
        [
            {
                "status": {
                    "error_code": "AIS.0000", 
                    "error_msg": "Succeeded."
                }, 
                "type": "quota_invoice", 
                "location": [
                    [65, 1006], 
                    [1388, 1006], 
                    [1388, 1863], 
                    [65, 1863]
                ],
                "content": {               
                    "code": "13XXXXXX1301",
                    "number": "40XXXX88",
                    "amount": "￥50.00",              
                    "location": "上海", 
                    "confidence": {                    
                        "code": 0.9253, 
                        "number": 0.9665,
                        "amount": 0.9848,
                        "location": 0.9847 
                    }                
                }
            }
        ] 
    },
    "error": "",
    "message": "ok"
}

异常返回结果

OCR识别失败响应示例

{
  "code": "58105",
  "data": null,
  "error": "Recognize Failed",
  "message": "OCR service call exception"
}

Token验证失败响应示例

{
  "code": "58401",
  "data": null,
  "error": "Failed to verify the token.",
  "message": "Login authentication failed."
}

返回参数说明

参数	必选	参数类型	说明
code	是	String	错误码
message	是	String	调用成功时为"ok"。调用失败时的错误信息。
data	是	Object	调用成功时表示调用结果，详见data数据结构。调用失败时为null。
error	是	String	错误信息。

data 数据结构

参数	必选	参数类型	说明
status	是	Object	指示各对应票证的识别状态。
content	是	Object	对应票证具体结构化识别的结果。
type	是	String	对应票证的类别。
location	是	Array [Array [Integer]]	各票证在原图上的坐标，依次分别为左上、右上、右下、左下。
confidence	是	Object	相关字段的置信度信息，置信度越大，表示本次识别的对应字段的可靠性越高，在统计意义上，置信度越大，准确率越高。置信度由算法给出，不直接等价于对应字段的准确率。

错误码说明

错误码	说明
0	成功。
58401	无权限。
58402	非法参数异常。
58500	服务异常。
58001	OCR服务异常。

响应格式说明

结果。 ""

无结果。 ""