API-Referenz

Projekte

Erstellen, auflisten, aktualisieren und verwalten Sie Projekte über die API.

Zuletzt aktualisiert:

Projects API

Verwalten Sie Ihre FloopFloop-Projekte programmgesteuert.

Projekte auflisten

GET /api/v1/projects

Gibt alle Projekte zurück, die dem authentifizierten Benutzer gehören.

Query Parameters:

  • teamId (optional) — Nach Team-Workspace filtern
curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Projekt erstellen

POST /api/v1/projects

Erstellt ein neues Projekt und startet die KI-Generierungspipeline.

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

Response (201):

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

Projekt abrufen

GET /api/v1/projects/{projectId}

Gibt Details zu einem bestimmten Projekt zurück.

Projekt aktualisieren

PATCH /api/v1/projects/{projectId}

Request Body (alle Felder optional):

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

Projekt archivieren

DELETE /api/v1/projects/{projectId}

Archiviert ein Projekt und gibt seine Subdomain frei. AWS-Ressourcen werden im Hintergrund bereinigt.

Projekt verfeinern

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

Senden Sie Follow-up-Anweisungen, um ein Live-Projekt zu ändern.

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

Wenn das Projekt gerade bereitgestellt wird, wird die Nachricht in die Warteschlange gestellt und automatisch nach Abschluss der aktuellen Bereitstellung verarbeitet.

Konversationen abrufen

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

Gibt den vollständigen Konversationsverlauf einschließlich Bereitstellungsmarkierungen und Nachrichten in der Warteschlange zurück.

Bibliothek durchsuchen

GET /api/v1/library

Query Parameters:

  • botType — Nach Typ filtern (site, app, bot, api, internal)
  • search — Nach Name oder Beschreibung suchen
  • sortnewest (Standard) oder popular
  • page — Seitennummer (Standard 1)
  • limit — Elemente pro Seite (1-50, Standard 20)

Bibliotheksprojekt klonen

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

Klont ein öffentliches Projekt aus der Bibliothek in Ihr Konto.