项目重分析前检查公开市场证据覆盖

POST /api/v1/projects/{projectId}/blueprint-analysis/preflight · preflightProjectReanalysis

按项目创建时钉定的 Blueprint 输入与当前公开市场快照重新执行覆盖预检。返回值与生成预检同形；重分析请求必须回传本次钉定的 marketSnapshotId，并在有缺口时显式确认。 PAT 不可调用本端点：与 reanalyze / pending / review 同口径，session-only（401）。

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

参数

projectId（必填）: string

响应字段 · 200

status（必填）: enum；取值：ready / ready_with_gaps / blocked
surveyVersionId（必填）: string
snapshot: BlueprintPreflightSnapshot
snapshot.id（必填）: string
snapshot.weekKey（必填）: string
snapshot.publishedAt（必填）: string
snapshot.ageDays（必填）: integer
snapshot.fallback（必填）: boolean —— true 表示使用 14 天窗口内的上一份合格快照
coverageGaps（必填）: BlueprintCoverageGap[]
coverageGaps[].code（必填）: string
coverageGaps[].platform（必填）: string
coverageGaps[].capability（必填）: string
coverageGaps[].reason（必填）: string
coverageGaps[].blocking（必填）: boolean
coverageGaps[].capabilityStatus: enum；取值：active / disabled / requires_authorization / unauthorized / policy_blocked / quarantined / rate_limited / failed / unsupported
requiresGapAcknowledgement（必填）: boolean
evidenceSummary（必填）: BlueprintEvidenceSummary
evidenceSummary.total（必填）: integer
evidenceSummary.facts（必填）: integer
evidenceSummary.signals（必填）: integer
evidenceSummary.estimates（必填）: integer
evidenceSummary.claims（必填）: integer
evidenceSummary.eligible（必填）: integer
evidenceSummary.estimateStatus（必填）: enum；取值：disabled_no_ground_truth

错误

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

请求示例（curl）

curl -X POST "https://你的项目.workflow.games/api/v1/projects/{projectId}/blueprint-analysis/preflight" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "status": "ready",
  "surveyVersionId": "018f3c2e-0000-7000-8000-000000000000",
  "coverageGaps": [
    {
      "code": "示例文本",
      "platform": "示例文本",
      "capability": "示例文本",
      "reason": "操作原因(会记入变更流)",
      "blocking": true
    }
  ],
  "requiresGapAcknowledgement": true,
  "evidenceSummary": {
    "total": 1,
    "facts": 1,
    "signals": 1,
    "estimates": 1,
    "claims": 1,
    "eligible": 1,
    "estimateStatus": "disabled_no_ground_truth"
  }
}

合同真值：OpenAPI 3.1（0.1.0）。

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