API 参考 / requirement-graph

绑定两个需求的引用关系

PUT /api/v1/requirements/{requirementId}/references/{targetRequirementId} · bindRequirementReference

以两个 canonical UUID 建立无向 references 关系。交换 source/target 仍命中同一条关系； 首次建立返回 201，已存在返回 200，重复调用不会产生新的 ChangeSet/Event。Agent 可直接调用， 不需要用户确认。

鉴权：项目 API Token（Authorization: Bearer wfp_…）。详见 Agent 接入。

参数

requirementId（必填）
string —— 小写、带连字符的 canonical UUID；不接受展示单号或首尾空白。
targetRequirementId（必填）
string —— 小写、带连字符的 canonical UUID；不接受展示单号或首尾空白。

响应字段 · 201

id（必填）
string
sourceType（必填）
string
sourceId（必填）
string
targetType（必填）
string
targetId（必填）
string
linkType（必填）
string
meta（必填）
object
createdAt（必填）
string
updatedAt（必填）
string

响应字段 · 200

id（必填）
string
sourceType（必填）
string
sourceId（必填）
string
targetType（必填）
string
targetId（必填）
string
linkType（必填）
string
meta（必填）
object
createdAt（必填）
string
updatedAt（必填）
string

错误

请求示例（curl）

curl -X PUT "https://你的项目.workflow.games/api/v1/requirements/{requirementId}/references/{targetRequirementId}" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 201
{
  "id": "018f3c2e-0000-7000-8000-000000000000",
  "sourceType": "示例文本",
  "sourceId": "018f3c2e-0000-7000-8000-000000000000",
  "targetType": "示例文本",
  "targetId": "018f3c2e-0000-7000-8000-000000000000",
  "linkType": "https://example.com",
  "meta": "示例文本",
  "createdAt": "示例文本",
  "updatedAt": "2026-08-01"
}

合同真值：OpenAPI 3.1（0.1.0）。

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

Workflow 正在加载…