API Referansı

Projeler

API üzerinden projeler oluşturun, listeleyin, güncelleyin ve yönetin.

Son güncelleme:

Projeler API

FloopFloop projelerinizi programatik olarak yönetin.

Projeleri Listele

GET /api/v1/projects

Kimliği doğrulanmış kullanıcıya ait tüm projeleri döndürür.

Sorgu Parametreleri:

  • teamId (optional) — Ekip çalışma alanına göre filtrele
curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Proje Oluştur

POST /api/v1/projects

Yeni bir proje oluşturur ve AI üretim sürecini başlatır.

İstek Gövdesi:

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

Yanıt (201):

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

Proje Getir

GET /api/v1/projects/{projectId}

Belirli bir projenin ayrıntılarını döndürür.

Proje Güncelle

PATCH /api/v1/projects/{projectId}

İstek Gövdesi (tüm alanlar isteğe bağlı):

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

Projeyi Arşivle

DELETE /api/v1/projects/{projectId}

Bir projeyi arşivler ve alt alan adını serbest bırakır. AWS kaynakları arka planda temizlenir.

Projeyi İyileştir

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

Canlı bir projeyi değiştirmek için takip talimatları gönderin.

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

Proje şu anda dağıtım yapıyorsa, mesaj sıraya alınır ve mevcut dağıtım tamamlandıktan sonra otomatik olarak işlenir.

Konuşmaları Getir

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

Dağıtım işaretçileri ve sıradaki mesajlar dahil tam konuşma geçmişini döndürür.

Kütüphaneye Gözat

GET /api/v1/library

Sorgu Parametreleri:

  • botType — Türe göre filtrele (site, app, bot, api, internal)
  • search — Ada veya açıklamaya göre ara
  • sortnewest (varsayılan) veya popular
  • page — Sayfa numarası (varsayılan 1)
  • limit — Sayfa başına öğe sayısı (1-50, varsayılan 20)

Kütüphane Projesini Klonla

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

Kütüphaneden genel bir projeyi hesabınıza klonlar.