提交任务

POST/api/open/v1/tasks/submitapplication/json

提交检测任务（application/json）。公共字段（outTradeNo/checkType/title 必传，callbackUrl/sandbox 可选）在顶层，类型专属参数收在 payload 子对象：相似度/AI 传 payload.fileBase64 或 payload.fileUrl（相似度支持 .pdf/.docx/.doc，AI 率另支持 .txt，单份 ≤25MB，正文可读文本 ≥500 字符）+ payload.fileName；参考文献检测传 payload.citations 引文数组（字符串数组，≤300 条）。成功返回 taskNo。

请求头

以下签名头对所有开放 API 通用，缺失或不合法将验签失败。

名称	说明
`X-App-Id`	应用标识，平台为机构分配的 App ID。
`X-Timestamp`	毫秒级时间戳；与服务器时间偏差须在 ±300 秒内。
`X-Nonce`	一次性随机串，10 分钟内不可重复，用于防重放。
`X-Signature`	对待签内容做 HMAC-SHA256（密钥为 appSecret）后的 Base64 签名值。

请求体字段（JSON）

请求体为 application/json；公共字段为顶层键，类型专属参数收在 payload 子对象（文件以 base64 内联在 payload.fileBase64）。

名称		类型	必填	说明
`outTradeNo`		`string`	是	机构侧订单号，机构内唯一，≤36 字符；重复提交返回 2011。
`checkType`		`int`	是	数字检测类型码（必填）：1=AI率检测 / 2=相似度检测 / 3=参考文献检测。更多检测能力持续开放中，如需其他类型请联系商务对接开通。
`title`		`string`	是	稿件标题（必传，≤255 字符）。随任务落库，并作为提交给服务商的稿件标题。
`callbackUrl`		`string`	否	本单回调地址（可选），覆盖机构默认回调配置；长度 ≤255 字符，超长直接拒收。
`sandbox`		`boolean`	否	沙箱（测试）模式（可选，默认 false）：用于联调，不计费、不消耗信用点，返回示例报告；请求与响应格式同正式接口。
`payload`	`fileBase64`	`string`	否	payload.fileBase64：待检测文件字节的 Base64 字符串（内联在 JSON），相似度/AI 用；与 fileUrl 二选一。相似度支持 .pdf/.docx/.doc，AI 率另支持 .txt；单份大小上限 25MB，且正文可解析出的文本须 ≥500 字符，否则按 2018 拒收。
	`fileName`	`string`	否	payload.fileName：文件名（含扩展名，如 paper.pdf），配合 fileBase64 用于识别文件类型。
	`fileUrl`	`string`	否	payload.fileUrl：文件下载地址（http/https），平台服务端拉取，相似度/AI 用；与 fileBase64 二选一。支持的格式、大小上限与最少字符数同 fileBase64。
	`citations`	`string[]`	否	payload.citations：参考文献检测（checkType=3）的引文数组：字符串数组，每条一条引文，最多 300 条。

请求体示例

JSON

{
  "outTradeNo": "OT20260718001",
  "checkType": 2,
  "title": "论文标题",
  "payload": {
    "fileName": "paper.pdf",
    "fileBase64": "JVBERi0xLjcK…（文件字节的 Base64）"
  }
}

响应示例

JSON

{ "code": 0, "codeMsg": "success", "data": { "taskNo": "20260718abc2nbausre" } }

响应字段

名称	类型	说明
`taskNo`	`string`	任务号，机构后续查询与取报告的凭据。
`sandbox`	`boolean?`	是否为沙箱（测试）任务。

可能的错误码

错误码	说明
`1401`	参数缺失或不合法
`1429`	请求过于频繁（负载限流，HTTP 429）
`1449`	系统繁忙，请稍后再试
`2001`	验签失败
`2002`	时间戳超窗
`2003`	重复请求
`2004`	应用不存在或已停用
`2005`	来源IP未授权
`2006`	信用点余额不足
`2011`	订单号重复
`2012`	不支持的检测类型
`2013`	文件缺失或不合法
`2016`	文件拉取失败
`2017`	检测类型未开通
`2018`	文件可读文本不足 500 字符（疑似扫描件/加密/损坏）

查看完整错误码列表 →