You need to enable JavaScript to run this app.
导航
财务票据识别
  • 文档首页
    • /
  • 财务票据识别

接口文档

最近更新时间：2021.12.16 13:58:38

首次发布时间：2021.12.16 13:58:38

我的收藏

接入指引

请先查看接入指引了解具体接入方式，再参考此文档完成接入。

请求API

名称内容
请求方式POST
Content-Typeapplication/x-www-form-urlencoded (传入参数不包含类型File)
是否需要鉴权是
图片要求1. 图片格式：JPG、JPEG、PNG、BMP等常见格式，建议使用JPG格式。
2. 图片像素尺寸：为了保证文字识别效果，推荐图片中火车票最短边长不低于256像素。
3. 图片文件大小：最大 4 MB。火车票主体尽量占据图片主要区域。
4. 注意图片质量：保证火车票图片足够清晰，不应该有因为压缩导致的噪声，避免对火车票正反面的遮挡、不当的光照（强光、暗光、逆光）等，否则会降低结果准确度。
5. 图片需要有版权，有肖像权，没有法律或者政策风险的。相关风险请注意评估。
6.火车票图片不可以是复印件、翻拍件、PS件等。

输入参数

Query参数：

参数可选/必选类型说明
Action必选String接口名，取值：OcrTrainTicket
Version必选String版本号，取值：2020-08-26

Body参数：

参数可选/必选类型说明
image_base64必选String驾驶证图片文件，base64编码

API返回

通用返回字段说明

请参考通用返回字段及错误码

data 字段说明

字段类型说明备注
ticket_mainmain_info主页面信息字段说明见下方

main_info 字段说明

字段类型说明备注
ticket_numString票号主页信息
start_stationString出发站主页信息
train_numString车次主页信息
end_stationString到达站主页信息
timeString出发时间主页信息
seat_numString座位号主页信息
priceString价格主页信息
seat_clsString座位等级主页信息
id_numString证件号主页信息
nameString姓名主页信息
sale_numString销售编号主页信息
sale_stationString售票车站主页信息
sub_typeString车票类型(正常票，补票等其他票)主页信息

错误码

HttpCode错误码错误消息描述
20010000"Success"请求成功
40050204"Parse Request Parameters Error"缺少参数
40150205"Image Size Exceeds Maximum Limit: please compress the image"图片大小超过上限
40050207"Image Decode Error: image format unsupported"图片解码错误，文件内容为空或格式错误
40050208"Invalid Input Image: No object detected in input image, bad input image"输入图片没有检测到火车票
40150400见下方鉴权错误信息鉴权失败
40450402"Request URL Error"无效的请求路径
50050500"Internal Error: please contact with bytedance engineering team"内部错误，需要联系开发人员

返回值示例

主页面图片返回值示例

{
   "code":10000,
   "data":{
      "ticket_main":{
         "ticket_num":"Q099454",
         "start_station":"南京南",
         "train_num":"G124",
         "end_station":"北京南",
         "time":"2015年07月10日12:21开",
         "seat_num":"11车13A号",
         "price":"¥443.5元",
         "seat_cls":"二等座",
         "id_num":"341126********4921",
         "name":"王XX",
         "sale_num":"10010000490718Q099454",
         "sale_station":"北京南售",
         "sub_type":"normal_ticket"
      }
   },
   "message":"Success",
   "request_id":"68981614972690780231606103381",
   "status":10000,
   "time_elapsed":"387.625781ms"
}