提交SAR解析任务

post
https://connect.zhihuiya3.xtdz.top/eurekals/open/sar/file/extract
在体验中心中试用

异步接口。通过专利PN下载原文，或直接上传PDF，创建一个SAR解析任务；成功时从data.task_id取得任务ID

调用步骤：1. pn和file必须且只能提供一个，PDF最大30MB、1000页；2. language可省略，默认EN；3. 提交成功返回status=true、data.status=PROCESSING；4. 使用data.task_id调用/file/detail，直到data.status为SUCCESS、FAILED或NOT_FOUND。

请求参数

此 API 接口支持的参数列表

名称类型示例描述
file
filedocument.pdf
待解析的PDF文件，最大30MB、1000页；与pn二选一
language
stringEN
结果语言：CN（中文）或EN（英文）
pn
stringUS10392366B2
专利公开号；与file二选一

响应结构

API 响应数据的结构说明

字段名类型示例描述
data
object{ "status": "PROCESSING", "task_id": "abc123xyz" }
任务提交结果
status
stringPROCESSING
提交状态，固定为PROCESSING，表示任务已创建。创建失败时通过外层status=false返回
task_id
stringabc123xyz
任务ID。提交成功后使用该ID调用 /file/detail 轮询任务状态
status
booleantrue
请求是否成功
error_msg
stringExactly one of pn or file must be provided
错误信息；成功时不返回
error_code
integer<int32>-
业务错误码；成功时为0
error_params
object{}
错误参数；成功时不返回

成功响应示例

成功调用 API 的响应示例

JSON 
{
  "data": {
    "status": "PROCESSING",
    "task_id": "abc123xyz"
  },
  "status": true,
  "error_msg": "Exactly one of pn or file must be provided",
  "error_code": 0,
  "error_params": {}
}

错误码

此接口可能返回的错误码列表

业务错误码

错误码描述
68300004请求参数异常!
68300005查询Api失败!
68300006解析基本存取错误!
68300007存在错误的请求!
68300008服务中断异常，请稍后再试!
68300010文件不符合上传规范!

平台错误码

错误码描述
67200000API整体限流错误!
67200001API整体限流错误！
67200002当前调用速率过快,超过当前配置限制QPS！
67200003申请token的key和secret传参不正确或者客户端已被禁用！
67200004请求的接口无权限请联系我们的支持人员！
67200005账户余额/调用次数不足！
67200006客户端超过开通有效期！
67200007当前调用超过当天配置使用额度！
67200008请检查query参数中必填的apikey是否传输！
67200009apikey与所传的bearerToken不匹配,请检查是否使用在有效期内的token！
67200012请求不合法！
67200100当前服务器状态正忙,请求响应超时！
67200101当前请求的Api不存在请检查请求Path！

HTTP 状态码

状态码描述
0请求成功
201Created
401Unauthorized
403Forbidden
404Not Found

性能指标

此接口的预期性能特征

正常响应时间

5000 ms

最大响应时间

10000 ms