生成前检查公开市场证据覆盖

POST /api/v1/orgs/{orgId}/blueprint-drafts/{draftId}/generation-preflight · preflightBlueprintGeneration

按已保存且已确认的 surveyVersionId 解析目标平台与竞品，并钉定当前可发布的公开市场快照； needs_review 恢复等重验场景可传 marketSnapshotId，强制检查任务原本钉定的历史快照。返回新鲜度、覆盖、证据分类计数和 Coverage Gap。ready_with_gaps 允许用户披露确认后继续； blocked 不允许生成。此结果不是授权令牌，真正生成时服务端会用同一 surveyVersionId 与 marketSnapshotId 重新检查，不能只信客户端。V1 只使用 public_market 数据。

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

参数

orgId（必填）: string
draftId（必填）: string

请求体

surveyVersionId（必填）: string —— 必须归属当前 draft 且 status=confirmed
marketSnapshotId: string —— 可选；传入时只预检该已发布或已取代的钉定快照，不跟随 current 指针

响应字段 · 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

错误

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

请求示例（curl）

curl -X POST "https://workflow.games/api/v1/orgs/{orgId}/blueprint-drafts/{draftId}/generation-preflight" \
  -H "Authorization: Bearer wfp_…" \
  -H "content-type: application/json" \
  --data '{"surveyVersionId":"018f3c2e-0000-7000-8000-000000000000","marketSnapshotId":"018f3c2e-0000-7000-8000-000000000000"}'

响应示例

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 参考索引