Skip to content

需求 API

需求以自然语言提交,由 AI 分析后生成结构化规格说明。

创建需求

http
POST /api/v1/projects/{project_id}/requirements
Authorization: Bearer <token>
Content-Type: application/json

{
  "title": "用户注册 API",
  "description": "创建用户注册端点,包含邮箱验证和密码哈希",
  "priority": "high"
}

优先级criticalhighmediumlow

列出需求

http
GET /api/v1/projects/{project_id}/requirements

获取需求

http
GET /api/v1/requirements/{requirement_id}

AI 分析

触发 AI 对需求进行分析,生成结构化规格说明。

http
POST /api/v1/requirements/{requirement_id}/analyze

响应 包含:

  • 功能性/非功能性需求识别
  • 验收标准
  • 复杂度评估
  • 建议的工作项

审批需求

http
POST /api/v1/requirements/{requirement_id}/approve

拒绝需求

http
POST /api/v1/requirements/{requirement_id}/reject
Content-Type: application/json

{
  "reason": "需求不够明确,请补充验收标准"
}

生成计划

需求审批后,生成执行计划。

http
POST /api/v1/requirements/{requirement_id}/generate-plan

响应 包含生成的工作项和执行节点。

Forgexa — AI 软件工厂