部署

Deployment API

管理您项目的部署。

部署 / 重新部署

POST /api/v1/projects/{projectId}/deploy

请求体（可选）：

{ "startOver": false }

触发新的部署。对于失败的部署，系统会自动从失败步骤重试。 设置 startOver: true 可跳过重试检测，从头完整运行流水线。

响应：

{
  "data": {
    "id": "deployment-uuid",
    "version": 3,
    "status": "queued",
    "isRetry": false,
    "queuePriority": 2
  }
}

检查部署状态

GET /api/v1/projects/{projectId}/status

返回实时部署进度。轮询此端点以跟踪部署状态。

{
  "data": {
    "step": 3,
    "totalSteps": 6,
    "status": "in_progress",
    "message": "Building your app...",
    "progress": 50
  }
}

可能的状态值：queued、in_progress、completed、failed、cancelled

回滚

POST /api/v1/projects/{projectId}/rollback

{ "targetDeploymentId": "deployment-uuid" }

将项目回滚至之前成功的部署版本。目标部署的状态必须为completed。

取消部署

POST /api/v1/projects/{projectId}/cancel

取消正在进行的部署并将项目重置为草稿状态。仅当项目状态为queued、generating 或 deploying 时有效。

重新激活项目

POST /api/v1/projects/{projectId}/reactivate

通过从保留的代码仓库创建全新部署来重新激活已暂停的项目。 消耗 1 个积分。