research 采集批次列表（平台超管）

GET /api/v1/research/ingest-batches · listResearchIngestBatches

返回采集批次列表（按创建时间倒序），可按来源 / 周 / 状态过滤。仅平台超管可访问。每项含阶段漏斗计数（发现 / 抓取 / 持久化 / 失败）、错误摘要、快照引用与时间戳。 partial ≠ failed：partial = 部分记录成功部分失败（成功数据保留但不自动发布）。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

参数

source: string
week: string
status: string
limit: integer

响应字段 · 200

items（必填）: ResearchIngestBatchListItem[]
items[].id（必填）: string
items[].week（必填）: string
items[].source（必填）: string
items[].status（必填）: enum；取值：queued / running / succeeded / partial / failed / canceled
items[].counts（必填）: ResearchIngestBatchCounts
items[].counts.discovered（必填）: integer —— Discover 返回的记录总数
items[].counts.fetched（必填）: integer —— Fetch 成功的记录数
items[].counts.persisted（必填）: integer —— 去凭据 + content hash 幂等后实际写入对象存储的记录数
items[].counts.failed（必填）: integer —— Fetch 失败的记录数（按分类）
items[].errorSummary: string
items[].triggeredBy（必填）: string
items[].createdAt（必填）: string
items[].finishedAt: string
items[].updatedAt（必填）: string

错误

401：Problem 错误响应
403：Problem 错误响应

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/research/ingest-batches?source=…&week=…" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "week": "示例文本",
      "source": "示例文本",
      "status": "queued",
      "counts": {
        "discovered": 1,
        "fetched": 1,
        "persisted": 1,
        "failed": 1
      },
      "triggeredBy": "示例文本",
      "createdAt": "示例文本",
      "updatedAt": "2026-08-01"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引