Riferimento API

Progetti

Crea, elenca, aggiorna e gestisci i progetti tramite l'API.

Ultimo aggiornamento:

API Progetti

Gestisci i tuoi progetti FloopFloop in modo programmatico.

Elenco dei progetti

GET /api/v1/projects

Restituisce tutti i progetti di proprietà dell'utente autenticato.

Parametri di query:

  • teamId (optional) — Filtra per workspace del team
curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Creazione di un progetto

POST /api/v1/projects

Crea un nuovo progetto e avvia la pipeline di generazione AI.

Corpo della richiesta:

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

Risposta (201):

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

Dettaglio di un progetto

GET /api/v1/projects/{projectId}

Restituisce i dettagli di un progetto specifico.

Aggiornamento di un progetto

PATCH /api/v1/projects/{projectId}

Corpo della richiesta (tutti i campi opzionali):

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

Archiviazione di un progetto

DELETE /api/v1/projects/{projectId}

Archivia un progetto e rilascia il suo sottodominio. Le risorse AWS vengono ripulite in background.

Raffinamento di un progetto

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

Invia istruzioni di follow-up per modificare un progetto live.

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

Se il progetto è attualmente in fase di distribuzione, il messaggio verrà messo in coda ed elaborato automaticamente al termine del deployment corrente.

Recupero delle conversazioni

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

Restituisce la cronologia completa delle conversazioni, inclusi i marcatori di deployment e i messaggi in coda.

Esplorazione della libreria

GET /api/v1/library

Parametri di query:

  • botType — Filtra per tipo (site, app, bot, api, internal)
  • search — Cerca per nome o descrizione
  • sort — newest (predefinito) o popular
  • page — Numero di pagina (predefinito 1)
  • limit — Elementi per pagina (1-50, predefinito 20)

Clonazione di un progetto dalla libreria

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

Clona un progetto pubblico dalla libreria nel tuo account.

PrecedenteAutenticazioneSuccessivoDeployment