API 参考 / research

research Evidence 审核队列（平台超管）

GET /api/v1/research/evidence · listResearchEvidence

返回 Evidence 审核队列列表，可按状态 / 来源 / 指标 key 过滤。仅平台超管可访问。 阻断（blocked）Evidence 清零前禁止发布快照。每条含审核留痕（审核人 / 理由 / 时间 / 版本）。

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

参数

status
string
source
string
metricKey
string
limit
integer

响应字段 · 200

items（必填）
ResearchEvidence[]
items[].id（必填）
string
items[].evidenceKind
enum —— metric 是结构化观测值；claim 是带出处的内容主张。本期 Claim 只锁合同，不接采集源。；取值：metric / claim
items[].metricClass
enum —— Qualifier 决定的指标类别。旧 estimated=true 迁移为 estimate；旧 estimated=false 一律为 legacy_unclassified，禁止猜成 fact，且不可进入 V2 快照。；取值：fact / signal / estimate / legacy_unclassified
items[].dataScope
enum —— 数据作用域。V1 全局市场快照只允许 public_market。；取值：public_market / tenant_first_party
items[].truthTier
enum —— 来源真值等级；等级定义由版本化 qualifier policy 管理。；取值：T0 / T1 / T2 / T3 / T4 / T5
items[].qualityStatus
enum —— 资格与质量状态。只有 qualified 且 snapshotEligible=true 的记录可成为候选成员。；取值：pending / qualified / needs_review / rejected / blocked / quarantined
items[].snapshotEligible
boolean
items[].normalizedRecordId（必填）
string —— 关联的标准化记录 id（血缘锚点）
items[].source（必填）
string
items[].gameKey
string —— 跨平台归一 key
items[].metricKey
ResearchEvidenceKey —— Evidence 的稳定 metric/claim key；具体词表由 evidenceKind 决定。
items[].claimKey
ResearchEvidenceKey —— Evidence 的稳定 metric/claim key；具体词表由 evidenceKind 决定。
items[].value（必填）
object —— 指标值（数值或区间估算，由 metric 定义决定）
items[].unit
string —— 单位（数据型结论展示必备口径；缺失为 null）
items[].timeWindow
string —— 时间窗（如 last_30_days；缺失为 null）
items[].sourceUrl
string —— 来源 URL（仅公开页面；无来源链接为 null）
items[].observedAt
string —— 数据采集时刻
items[].region
string
items[].language
string
items[].sample
string —— 样本口径描述
items[].estimated（必填）
boolean —— 兼容字段；新记录严格由 metricClass=estimate 派生
items[].confidence（必填）
number —— 置信度 0.0~1.0
items[].status（必填）
enum —— Evidence 状态机：approved_as_estimated 只表示历史状态。V2 审核员只能通过、驳回或阻断，不能改变 Qualifier 已确定的 metricClass。；取值：pending / approved / approved_as_estimated / rejected / blocked / expired
items[].reviewedBy
string —— 审核人 id
items[].reviewReason
string —— 审核理由（驳回必填）
items[].reviewedAt
string
items[].reviewVersion
integer —— 审核版本号（每次流转自增）
items[].metricVersions（必填）
object —— lineage 钉定的字典版本（快照复现用）
items[].ontologyVersions（必填）
object —— lineage 钉定的本体版本
items[].createdAt（必填）
string
items[].updatedAt（必填）
string

错误

请求示例（curl）

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

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "normalizedRecordId": "018f3c2e-0000-7000-8000-000000000000",
      "source": "示例文本",
      "value": {},
      "estimated": true,
      "confidence": 1,
      "status": "pending",
      "metricVersions": {},
      "ontologyVersions": {},
      "createdAt": "示例文本",
      "updatedAt": "2026-08-01"
    }
  ]
}

合同真值：OpenAPI 3.1（0.1.0）。

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

Workflow 正在加载…