Referensi API

Proyek

Buat, daftar, perbarui, dan kelola proyek melalui API.

Terakhir diperbarui:

API Proyek

Kelola proyek FloopFloop Anda secara terprogram.

Daftar Proyek

GET /api/v1/projects

Mengembalikan semua proyek yang dimiliki oleh pengguna yang terautentikasi.

Query Parameters:

  • teamId (opsional) — Filter berdasarkan ruang kerja tim
curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Buat Proyek

POST /api/v1/projects

Membuat proyek baru dan memulai pipeline pembuatan AI.

Request Body:

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

Respons (201):

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

Ambil Proyek

GET /api/v1/projects/{projectId}

Mengembalikan detail proyek tertentu.

Perbarui Proyek

PATCH /api/v1/projects/{projectId}

Request Body (semua kolom opsional):

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

Arsipkan Proyek

DELETE /api/v1/projects/{projectId}

Mengarsipkan proyek dan melepaskan subdomain-nya. Sumber daya AWS dibersihkan di latar belakang.

Perhalus Proyek

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

Kirim instruksi lanjutan untuk memodifikasi proyek yang sedang berjalan.

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

Jika proyek sedang dalam proses deploy, pesan akan diantrekan dan diproses secara otomatis setelah deployment saat ini selesai.

Ambil Percakapan

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

Mengembalikan riwayat percakapan lengkap termasuk penanda deployment dan pesan yang diantrekan.

Jelajahi Library

GET /api/v1/library

Query Parameters:

  • botType — Filter berdasarkan tipe (site, app, bot, api, internal)
  • search — Cari berdasarkan nama atau deskripsi
  • sort — newest (default) atau popular
  • page — Nomor halaman (default 1)
  • limit — Item per halaman (1-50, default 20)

Kloning Proyek Library

POST /api/v1/library/{projectId}/clone
{ "subdomain": "my-clone" }

Mengkloning proyek publik dari library ke akun Anda.

SebelumnyaAutentikasiBerikutnyaDeployment