API 参考 / research

审核 Evidence（平台超管）

POST /api/v1/research/evidence · reviewResearchEvidence

对一条 Evidence 执行审核动作（approve / reject / block）。 审核人来自会话上下文，不由 body 伪造；驳回必填理由。审核流转写审计。 仅平台超管可访问。阻断项清零前禁止发布快照。

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

请求体

evidenceId（必填）
string
action（必填）
enum —— 审核员只能通过、驳回或阻断；数据类别由版本化 Qualifier 决定，审核动作不得改写。；取值：approve / reject / block
reason
string —— 审核理由（reject / block 必填）

响应字段 · 200

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

错误

请求示例（curl）

curl -X POST "https://你的项目.workflow.games/api/v1/research/evidence" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"evidenceId":"018f3c2e-0000-7000-8000-000000000000","action":"approve","reason":"操作原因(会记入变更流)"}'

响应示例

HTTP/1.1 200
{
  "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 正在加载…