按 Evidence 查询真实数据血缘（平台超管）

GET /api/v1/research/lineage/evidence/{evidenceId} · getResearchEvidenceLineage

返回 Evidence 钉定的 Blob → Artifact → Observation → Qualifier → Evidence 只读链。仅返回脱敏元数据，不返回 raw body、对象存储 key、请求 metadata、请求指纹或凭据。 仅平台超管可访问。

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

参数

evidenceId（必填）: string

响应字段 · 200

blob（必填）: ResearchLineageBlob
blob.id（必填）: string
blob.contentHash（必填）: string
blob.contentType（必填）: string
blob.sizeBytes（必填）: integer
blob.createdAt（必填）: string
artifact（必填）: ResearchLineageArtifact
artifact.id（必填）: string
artifact.blobId（必填）: string
artifact.capabilityId（必填）: string
artifact.executionId: string
artifact.source（必填）: string
artifact.sourceUrl（必填）: string
artifact.region: string
artifact.language: string
artifact.sourceRecordId（必填）: string
artifact.responseStatus（必填）: integer
artifact.schemaFingerprint（必填）: string
artifact.observedAt（必填）: string
artifact.createdAt（必填）: string
observation（必填）: ResearchLineageObservation
observation.id（必填）: string
observation.artifactId（必填）: string
observation.parserVersion（必填）: string
observation.metricKey（必填）: string
observation.dimensions（必填）: object
observation.value（必填）: object
observation.unit（必填）: string
observation.metricClass（必填）: enum —— Qualifier 决定的指标类别。旧 estimated=true 迁移为 estimate；旧 estimated=false 一律为 legacy_unclassified，禁止猜成 fact，且不可进入 V2 快照。；取值：fact / signal / estimate / legacy_unclassified
observation.truthTier（必填）: enum —— 来源真值等级；等级定义由版本化 qualifier policy 管理。；取值：T0 / T1 / T2 / T3 / T4 / T5
observation.qualityStatus（必填）: enum —— 资格与质量状态。只有 qualified 且 snapshotEligible=true 的记录可成为候选成员。；取值：pending / qualified / needs_review / rejected / blocked / quarantined
observation.snapshotEligible（必填）: boolean
observation.qualifierVersion（必填）: string
observation.observedAt（必填）: string
observation.createdAt（必填）: string
evidence（必填）: ResearchLineageEvidence
evidence.id（必填）: string
evidence.sourceObservationId（必填）: string
evidence.sourceArtifactId（必填）: string
evidence.status（必填）: enum —— Evidence 状态机：approved_as_estimated 只表示历史状态。V2 审核员只能通过、驳回或阻断，不能改变 Qualifier 已确定的 metricClass。；取值：pending / approved / approved_as_estimated / rejected / blocked / expired
evidence.reviewedBy: string
evidence.reviewReason: string
evidence.reviewVersion（必填）: integer
evidence.qualifierVersion（必填）: string
evidence.createdAt（必填）: string

错误

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

请求示例（curl）

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

响应示例

HTTP/1.1 200
{
  "blob": {
    "id": "018f3c2e-0000-7000-8000-000000000000",
    "contentHash": "示例文本",
    "contentType": "示例文本",
    "sizeBytes": 1,
    "createdAt": "示例文本"
  },
  "artifact": {
    "id": "018f3c2e-0000-7000-8000-000000000000",
    "blobId": "018f3c2e-0000-7000-8000-000000000000",
    "capabilityId": "018f3c2e-0000-7000-8000-000000000000",
    "source": "示例文本",
    "sourceUrl": "https://example.com",
    "sourceRecordId": "018f3c2e-0000-7000-8000-000000000000",
    "responseStatus": 1,
    "schemaFingerprint": "示例文本",
    "observedAt": "示例文本",
    "createdAt": "示例文本"
  },
  "observation": {
    "id": "018f3c2e-0000-7000-8000-000000000000",
    "artifactId": "018f3c2e-0000-7000-8000-000000000000",
    "parserVersion": "示例文本",
    "metricKey": "示例文本",
    "dimensions": {},
    "value": {},
    "unit": "示例文本",
    "metricClass": "fact",
    "truthTier": "T0",
    "qualityStatus": "pending",
    "snapshotEligible": true,
    "qualifierVersion": "示例文本",
    "observedAt": "示例文本",
    "createdAt": "示例文本"
  },
  "evidence": {
    "id": "018f3c2e-0000-7000-8000-000000000000",
    "sourceObservationId": "018f3c2e-0000-7000-8000-000000000000",
    "sourceArtifactId": "018f3c2e-0000-7000-8000-000000000000",
    "status": "pending",
    "reviewVersion": 1,
    "qualifierVersion": "示例文本",
    "createdAt": "示例文本"
  }
}

合同真值：OpenAPI 3.1（0.1.0）。

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