查询从 URL 异步拉取摄入任务状态

GET

/v1/ingest/task

查询异步摄入任务的处理状态。status=COMPLETED 时返回结果文档 / 版本 ID 供定位结果 Version；status=FAILED / 重试中时返回最近一次失败原因。仅任务受理方可查询。

参数

请求头参数

Authorization*

访问令牌以 Bearer 方案在 HTTP Authorization 请求头携带。请在此填入完整值（含 Bearer 前缀），例如：Bearer <accessToken>。

类型

string

必填

示例"Bearer <accessToken>"

X-Atk-User-Token

强通道（可选）：以某已签发的 atkonbase 用户会话 token 调用，ACL 解析与操作归属走该用户。与弱通道 X-Atk-Act-As-Source(-Id) 互斥——同时携带返回业务码 101008。两个 SDK 均由 client 侧拦截器统一注入（actAsToken()），此处仅为门户演练暴露。

类型

string

X-Atk-Act-As-Source

弱通道（可选）：外部身份来源标识，须与 X-Atk-Act-As-Source-Id 成对携带，缺一返回业务码 101009。仅当该 Client 的 act_as_user_allowed=true 时生效，否则静默降级为 APP_ONLY；与强通道互斥。两个 SDK 均由 client 侧拦截器统一注入（actAsSource()），此处仅为门户演练暴露。

类型

string

X-Atk-Act-As-Source-Id

弱通道（可选）：外部身份在其来源系统内的 ID，须与 X-Atk-Act-As-Source 成对携带，缺一返回业务码 101009。

类型

string

查询参数

taskId*

类型

string

必填

响应

OK

Content-Type

*/*

{

  

"code": 0,

  

"data": {

  

  

"taskId": "string",

  

  

"status": "string",

  

  

"attemptCount": 0,

  

  

"lastError": "string",

  

  

"resultDocId": "string",

  

  

"resultVersionId": "string"

  

},

  

"ts": 0,

  

"rid": "string",

  

"msg": "string",

  

"success": true

}

GET

/v1/ingest/task

试验场

服务器

请求头

Authorization*

X-Atk-User-Token

X-Atk-Act-As-Source

X-Atk-Act-As-Source-Id

变量

键

值

taskId*

示例

技术支持 VitePress OpenAPI