API 概览

FloopFloop 公共 API

FloopFloop API 允许您以编程方式创建、管理和部署 Web 项目。它专为 AI 智能体、CI/CD 流水线以及希望将 FloopFloop 集成到其工作流中的开发者而设计。

基础 URL

https://floopfloop.com/api/v1

所有 API 端点均以 /api/v1 为前缀。API 使用 JSON 格式作为请求和响应体。

前提条件

• 拥有 Business 订阅计划的 FloopFloop 账户
• API 密钥（从账户设置中生成）

平台管理员无论订阅计划如何，均可访问 API。

快速开始

1. 从 Account → API Keys 生成 API 密钥

2. 发起您的第一个 API 调用：

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

3. 创建一个项目：

curl -X POST https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My API Project",
    "subdomain": "my-api-project",
    "prompt": "A portfolio website with a modern dark theme"
  }'

响应格式

所有成功响应均封装在 data 信封中：

{
  "data": {
    "id": "...",
    "name": "My Project",
    ...
  }
}

错误响应使用 error 信封：

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: name, subdomain, prompt"
  }
}