ATKONBASE

外观

摄入错误码（181*） ​

段位：181001 - 181999；当前 3 个；全部 V1 暴露

通用约定（HTTP status / code=1 兜底 / 响应结构）见 README

经 V1 /v1/ingest/* 端点暴露：POST /v1/ingest/register-object（登记已在存储中的对象）、POST /v1/ingest/from-url（从外部 URL 拉取并建立版本）、GET /v1/ingest/task（查异步拉取任务状态）。摄入链路还会返回存储侧的 存储错误码 173*（对象登记的命名空间校验 / URL 合法性 / 拉取失败 / 大小超限），以及命中文件 / 元数据校验时的 文件错误码 179*。

181001 INGEST_TARGET_AMBIGUOUS ​

  • HTTP status：200
  • 含义：摄入目标二选一冲突
  • 典型触发条件：register-object / from-url 同时提供了 docId（向已有文档追加版本）与 containerId + title（新建文档）
  • 处理建议：二选一——追加版本只传 docId；新建文档只传 containerId + title
  • 示例响应：
json
{ "code": 181001, "msg": "摄入目标二选一：docId 与 containerId+title 不能同时提供", "data": null }

181002 INGEST_TARGET_REQUIRED ​

  • HTTP status：200
  • 含义：摄入目标缺失
  • 典型触发条件：register-object / from-url 既未提供 docId，也未提供 containerId + title
  • 处理建议：提供 docId（已有文档）或 containerId + title（新建文档）之一
  • 示例响应：
json
{ "code": 181002, "msg": "摄入目标缺失：需提供 docId 或 containerId+title", "data": null }

181003 INGEST_TASK_NOT_FOUND ​

  • HTTP status：200
  • 含义：摄入任务不存在
  • 典型触发条件：GET /v1/ingest/task 携带的 taskId 查无对应记录或无权访问。出于安全考虑，任务无权访问与不存在返回同一错误码
  • 处理建议：使用 from-url 转异步时返回的受理回执中的 taskId 查询；任务完成后另会通过 document.updated Webhook 通知
  • 示例响应：
json
{ "code": 181003, "msg": "摄入任务不存在", "data": null }