Visão Geral da API

API Pública FloopFloop

A API FloopFloop permite-te criar, gerir e publicar projetos web de forma programática. Foi concebida para agentes de IA, pipelines CI/CD e programadores que queiram integrar o FloopFloop nos seus fluxos de trabalho.

URL Base

https://floopfloop.com/api/v1

Todos os endpoints da API têm o prefixo /api/v1. A API utiliza JSON para os corpos dos pedidos e respostas.

Requisitos

• Uma conta FloopFloop com plano de subscrição Business
• Uma chave de API (gerada nas definições da tua conta)

Os administradores da plataforma têm acesso à API independentemente do seu plano de subscrição.

Início Rápido

1. Gera uma chave de API em Account → API Keys

2. Faz a tua primeira chamada à API:

curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_api_key_here"

3. Cria um projeto:

curl -X POST https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My API Project",
    "subdomain": "my-api-project",
    "prompt": "A portfolio website with a modern dark theme"
  }'

Formato das Respostas

Todas as respostas bem-sucedidas são envolvidas num envelope data:

{
  "data": {
    "id": "...",
    "name": "My Project",
    ...
  }
}

As respostas de erro utilizam um envelope error:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: name, subdomain, prompt"
  }
}