API 参考

项目

通过 API 创建、列出、更新和管理项目。

最后更新： 2026年5月28日

Projects API

以编程方式管理您的 FloopFloop 项目。

列出项目

GET /api/v1/projects

返回已认证用户拥有的所有项目。

查询参数：

teamId（可选）— 按团队工作区筛选

curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

创建项目

POST /api/v1/projects

创建新项目并启动 AI 生成流水线。

请求体：

{
  "name": "My Project",          // required
  "subdomain": "my-project",     // required, lowercase
  "prompt": "Description...",    // required
  "botType": "app",              // optional: site, app, bot, api, internal
  "isAuthProtected": true,       // optional, default true
  "teamId": "uuid",              // optional, for team workspace
  "attachments": [               // optional
    {
      "key": "uploads/userId/fileId/file.png",
      "fileName": "file.png",
      "fileType": "image/png",
      "fileSize": 12345
    }
  ]
}

响应 (201)：

{
  "data": {
    "project": { "id": "...", "name": "My Project", "status": "queued", ... },
    "deployment": { "id": "...", "version": 1, "status": "pending" }
  }
}

获取项目

GET /api/v1/projects/{projectId}

返回特定项目的详细信息。

更新项目

PATCH /api/v1/projects/{projectId}

请求体（所有字段均为可选）：

{
  "name": "New Name",
  "description": "Updated description",
  "isPublic": true,
  "isAuthProtected": false,
  "hasBranding": false
}

归档项目

DELETE /api/v1/projects/{projectId}

归档项目并释放其子域名。AWS 资源将在后台清理。

优化项目

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

发送后续指令以修改已上线的项目。

{
  "message": "Add a contact form to the homepage",
  "codeEditOnly": false,         // optional, true for code-only edits (cheaper)
  "attachments": []              // optional
}

如果项目当前正在部署，消息将被排队并在当前部署完成后自动处理。

获取对话记录

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

返回完整的对话历史，包括部署标记和排队消息。

浏览模板库

GET /api/v1/library

查询参数：

botType — 按类型筛选（site, app, bot, api, internal）
search — 按名称或描述搜索
sort — newest（默认）或 popular
page — 页码（默认 1）
limit — 每页条数（1-50，默认 20）

克隆模板库项目

POST /api/v1/library/{projectId}/clone

{ "subdomain": "my-clone" }

将模板库中的公共项目克隆到您的账户。