Skip to main content
POST
国内通用票据v2接口识别

授权

x-ti-app-id
string
header
必填

登录Textin后前往 "工作台-账号设置-开发者信息" 查看 x-ti-app-id

x-ti-secret-code
string
header
必填

登录Textin后前往 "工作台-账号设置-开发者信息" 查看 x-ti-secret-code

查询参数

coord_restore
enum<integer>
默认值:0

调整各字段的返回坐标逻辑,1代表坐标以原图为基准,0代表坐标以票据切图为基准,默认为0

可用选项:
0,
1
specific_pages
string

指定多页样本中需要识别的样本,可以使用"1,3,2"形式来逐页选择,或"2-4"形式来连续选择,返回结果会重新排序以遵照源文件顺序,默认为空,识别所有页面

示例:

"3-5,1"

crop_complete_image
enum<integer>
默认值:0

选择是否需要输出各票据图片,1为输出各票据切片base64编码,0为不输出各票据图片,默认为0

可用选项:
0,
1
crop_value_image
enum<integer>
默认值:0

选择是否返回关键字段切图图片,1为输出字段图片,0为不输出字段图片,默认为0

可用选项:
0,
1
merge_digital_elec_invoice
enum<integer>
默认值:0

支持将多页全电票的结果合并为一页,1为合并,0为不合并,默认为0 当且仅当一份多页样本的每一页都是全电票,且每张发票的发票号码都一致时才可合并。

可用选项:
0,
1
return_ppi
enum<integer>
默认值:0

返回pdf解码ppi

可用选项:
0,
1

请求体

application/octet-stream

支持以下两种请求格式

  1. Content-Type: application/octet-stream 要上传的图片,目前支持jpg、png、bmp、pdf、tiff、ofd、xml、单帧gif等大部分格式,pdf和ofd文件支持多页​请注意,请求体的数据格式为本地文件的二进制流,非 FormData 或其他格式。文件大小不超过 50M,图像宽高须介于 20 和 10000(像素)之间。

  2. Content-Type: text/plain 请求体的数据格式为文本,内容为在线文件的URL链接(支持http以及https协议)。在线文件大小不超过 50M,图像宽高须介于 20 和 10000(像素)之间。

The body is of type file.

响应

200 - application/json
code
enum<integer>
必填

错误码

  • 200: success
  • 40101: x-ti-app-id 或 x-ti-secret-code 为空
  • 40102: x-ti-app-id 或 x-ti-secret-code 无效,验证失败
  • 40003: 余额不足,请充值后再使用
  • 40004: 参数错误,请查看技术文档,检查传参
  • 40007: 机器人不存在或未发布
  • 40008: 机器人未开通,请至市场开通后重试
  • 40301: 文件类型不支持,接口会返回实际检测到的文件类型,如“当前文件类型为.gif”
  • 40302: 上传文件大小不符,文件大小不超过 50M
  • 40303: 文件类型不支持
  • 40304: 图片尺寸不符,图像宽高须介于 20 和 10000(像素)之间
  • 40305: 识别文件未上传
  • 40306: QPS超过限制,收到此状态码时请勿重试,持续请求可能触发IP流控,如需扩容请联系商务
  • 40400: 无效的请求链接,请检查链接是否正确
  • 30203: 基础服务故障,请稍后重试
  • 500: 服务器内部错误
可用选项:
200,
40101,
40102,
40003,
40004,
40007,
40008,
40301,
40302,
40303,
40304,
40305,
40306,
40400,
30203,
500
示例:

200

message
string
必填

成功或错误信息

示例:

"success"

pageNum
integer

总页数

示例:

1

pages
object[]

样本每页的识别结果