プロジェクト

Projects API

FloopFloop プロジェクトをプログラムで管理します。

プロジェクト一覧の取得

GET /api/v1/projects

認証済みユーザーが所有するすべてのプロジェクトを返します。

クエリパラメータ：

• teamId (optional) — チームワークスペースでフィルタリング

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" }

ライブラリから公開プロジェクトをアカウントにクローンします。