REST API 开发者文档概述

简介

本文档旨在为开发者提供完整的 文件上传及异步处理结果获取 的 REST API 使用指南。通过本 API，开发者可实现以下能力：

- 向服务端安全上传文件
- 查询文件处理状态
- 异步获取处理后的结果
- 上传人工审核后的结果(以提高识别引擎后续识别率)

适用于需要集成票据等文档处理能力（如 AI 识别、内容审核等）的应用场景。

- 应用开发者：需将文件处理功能集成到自有系统的开发人员
- 技术团队负责人：评估 API 功能是否符合业务需求
- 第三方服务集成商：需与企业现有系统对接的技术人员

功能模块	描述
文件上传	支持多格式文件上传，支持单个或批量文件上传
任务状态查询	实时追踪文件处理进度（如排队中/处理中/已完成/失败）
结果获取	通过异步回调或主动轮询获取结构化结果（JSON）
结果上传	更新文件处理结果。通常用于人工审核校对后，上传修改后的key-value。

- API 凭证：从Textin工作台获取有效的 x-ti-app-id和 x-ti-secret-code
- 访问权限：确保账号已开通对应接口的调用权限
- 基础工具：熟悉 HTTP 协议及 RESTful 设计规范，准备测试工具（如 Postman）