Dokumentacja API

Projekty

Twórz, listuj, aktualizuj i zarządzaj projektami przez API.

Ostatnia aktualizacja:

API projektów

Zarządzaj projektami FloopFloop w sposób programatyczny.

Listowanie projektów

GET /api/v1/projects

Zwraca wszystkie projekty należące do uwierzytelnionego użytkownika.

Parametry zapytania:

  • teamId (opcjonalny) — Filtruj według przestrzeni roboczej zespołu
curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Tworzenie projektu

POST /api/v1/projects

Tworzy nowy projekt i uruchamia potok generowania AI.

Treść żądania:

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

Odpowiedź (201):

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

Pobieranie projektu

GET /api/v1/projects/{projectId}

Zwraca szczegóły określonego projektu.

Aktualizacja projektu

PATCH /api/v1/projects/{projectId}

Treść żądania (wszystkie pola opcjonalne):

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

Archiwizacja projektu

DELETE /api/v1/projects/{projectId}

Archiwizuje projekt i zwalnia jego subdomenę. Zasoby AWS są czyszczone w tle.

Ulepszanie projektu

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

Wyślij dodatkowe instrukcje, aby zmodyfikować działający projekt.

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

Jeśli projekt jest aktualnie wdrażany, wiadomość zostanie umieszczona w kolejce i przetworzona automatycznie po zakończeniu bieżącego wdrożenia.

Pobieranie historii konwersacji

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

Zwraca pełną historię konwersacji, w tym znaczniki wdrożeń i wiadomości w kolejce.

Przeglądanie biblioteki

GET /api/v1/library

Parametry zapytania:

  • botType — Filtruj według typu (site, app, bot, api, internal)
  • search — Szukaj według nazwy lub opisu
  • sort — newest (domyślnie) lub popular
  • page — Numer strony (domyślnie 1)
  • limit — Elementów na stronę (1–50, domyślnie 20)

Klonowanie projektu z biblioteki

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

Klonuje publiczny projekt z biblioteki na twoje konto.

PoprzedniUwierzytelnianieNastępnyWdrożenia