Referencia de la API

Proyectos

Crea, lista, actualiza y gestiona proyectos a través de la API.

Última actualización:

API de proyectos

Gestiona tus proyectos de FloopFloop de forma programática.

Listar proyectos

GET /api/v1/projects

Devuelve todos los proyectos del usuario autenticado.

Parámetros de consulta:

  • teamId (opcional) — Filtrar por espacio de trabajo de equipo
curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Crear proyecto

POST /api/v1/projects

Crea un nuevo proyecto e inicia el pipeline de generación con IA.

Cuerpo de la solicitud:

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

Respuesta (201):

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

Obtener proyecto

GET /api/v1/projects/{projectId}

Devuelve los detalles de un proyecto específico.

Actualizar proyecto

PATCH /api/v1/projects/{projectId}

Cuerpo de la solicitud (todos los campos son opcionales):

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

Archivar proyecto

DELETE /api/v1/projects/{projectId}

Archiva un proyecto y libera su subdominio. Los recursos de AWS se limpian en segundo plano.

Refinar proyecto

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

Envía instrucciones de seguimiento para modificar un proyecto en producción.

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

Si el proyecto se está implementando actualmente, el mensaje se pondrá en cola y se procesará automáticamente cuando finalice la implementación actual.

Obtener conversaciones

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

Devuelve el historial completo de conversaciones, incluidos los marcadores de implementación y los mensajes en cola.

Explorar la biblioteca

GET /api/v1/library

Parámetros de consulta:

  • botType — Filtrar por tipo (site, app, bot, api, internal)
  • search — Buscar por nombre o descripción
  • sort — newest (predeterminado) o popular
  • page — Número de página (predeterminado 1)
  • limit — Elementos por página (1-50, predeterminado 20)

Clonar proyecto de la biblioteca

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

Clona un proyecto público de la biblioteca a tu cuenta.

AnteriorAutenticaciónSiguienteDespliegues