Referência da API

Projetos

Cria, lista, atualiza e gere projetos através da API.

Última atualização:

API de Projetos

Gere os teus projetos FloopFloop de forma programática.

Listar Projetos

GET /api/v1/projects

Devolve todos os projetos do utilizador autenticado.

Parâmetros de Consulta:

  • teamId (opcional) — Filtrar por espaço de trabalho de equipa
curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Criar Projeto

POST /api/v1/projects

Cria um novo projeto e inicia o pipeline de geração por IA.

Corpo do Pedido:

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

Resposta (201):

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

Obter Projeto

GET /api/v1/projects/{projectId}

Devolve os detalhes de um projeto específico.

Atualizar Projeto

PATCH /api/v1/projects/{projectId}

Corpo do Pedido (todos os campos opcionais):

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

Arquivar Projeto

DELETE /api/v1/projects/{projectId}

Arquiva um projeto e liberta o seu subdomínio. Os recursos AWS são limpos em segundo plano.

Refinar Projeto

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

Envia instruções de acompanhamento para modificar um projeto em produção.

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

Se o projeto estiver atualmente a ser publicado, a mensagem será colocada em fila e processada automaticamente após a conclusão do deployment atual.

Obter Conversas

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

Devolve o histórico completo da conversa, incluindo marcadores de deployment e mensagens em fila.

Explorar Biblioteca

GET /api/v1/library

Parâmetros de Consulta:

  • botType — Filtrar por tipo (site, app, bot, api, internal)
  • search — Pesquisar por nome ou descrição
  • sort — newest (predefinição) ou popular
  • page — Número de página (predefinição 1)
  • limit — Itens por página (1-50, predefinição 20)

Clonar Projeto da Biblioteca

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

Clona um projeto público da biblioteca para a tua conta.

AnteriorAutenticaçãoSeguinteDeployments