API 参考 / research

research 数据源兼容投影（平台超管）

GET /api/v1/research/sources · listResearchSources

已废弃的来源级兼容读接口。只从 Capability Registry 的 List 结果按 source 确定性聚合， 不执行 Health/connector 请求或其它外部 I/O。来源内任一阻断能力会按固定优先级投影为来源状态； 完整能力状态、恢复理由和调度配置必须读取 /research/capabilities。仅平台超管可访问。

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

响应字段 · 200

items（必填）
ResearchSource[]
items[].name（必填）
string —— 来源标识（与 connector.Name 对齐），如 steam / dev-stub
items[].displayName（必填）
string
items[].status（必填）
enum；取值：active / disabled / requires_authorization / unauthorized / policy_blocked / quarantined / rate_limited / failed / unsupported
items[].compliance（必填）
ResearchSourceCompliance
items[].compliance.robotsAllowed（必填）
boolean —— robots.txt 是否允许采集目标路径
items[].compliance.requiresLogin（必填）
boolean —— 是否需登录才能访问目标数据（无凭据即 policy_blocked）
items[].compliance.paywall（必填）
boolean —— 是否有付费墙（绕过 = 禁止采集）
items[].version（必填）
string —— 按 capability key 排序的 capability@contractVersion 兼容摘要
items[].updatedAt（必填）
string

错误

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/research/sources" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "name": "示例标题",
      "displayName": "示例标题",
      "status": "active",
      "compliance": {
        "robotsAllowed": true,
        "requiresLogin": true,
        "paywall": true
      },
      "version": "示例文本",
      "updatedAt": "2026-08-01"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

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

Workflow 正在加载…