Todas as coleções

Primeiros passos

O Buildprint oferece uma API REST para implantar e gerenciar agentes, revisões de código, automações e testes de projeto nos seus apps do Bubble.

A API REST pública está atualmente em versão beta. Os endpoints estão disponíveis, mas a interface da API pode mudar sem aviso prévio à medida que o produto evolui.

URL base

A API REST está disponível em:

https://api.buildprint.ai/api/v1

Esquema OpenAPI

curl https://api.buildprint.ai/api/v1/openapi.json

Criar um token

  1. Peça a um administrador do workspace para acessar Agent > Integrations > API no Buildprint.

  2. Crie um token da API REST e dê a ele um nome descritivo.

  3. Armazene o token bp_ retornado em um local seguro. Ele só é exibido uma vez.

  4. Envie o token em todas as solicitações autenticadas como Authorization: Bearer bp_...

Os tokens podem ter escopo para todos os projetos do workspace ou para projetos específicos.

Início rápido

BASE_URL="https://api.buildprint.ai/api/v1"
TOKEN="bp_your_workspace_token"

curl --request POST "$BASE_URL/agents" \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "appId": "your-bubble-app-id",
    "prompt": "Inspect the checkout flow and tell me why the webhook retry path fails.",
    "model": "buildprint-gpt-5.3-codex"
  }'

curl --request GET "$BASE_URL/agents/<agentId>" \
  --header "Authorization: Bearer $TOKEN"

Autenticação e escopo

  • Os tokens da API REST têm escopo para um único workspace.

  • Um token só pode ser usado para IDs de apps de projetos verificados do Buildprint dentro desse workspace.

  • Revogar um token pela interface do Buildprint interrompe imediatamente todas as solicitações futuras.

Modelos e responsabilidade pela execução

  • Os modelos hospedados pelo Buildprint usam o saldo de créditos do workspace e podem ser executados sem userEmail.

  • Os modelos de provedores conectados exigem userEmail de um membro do workspace que tenha credenciais ativas do provedor conectadas ao workspace do Buildprint.

  • Os valores de esforço de raciocínio são none, low, medium e high. O padrão é medium.

  • Os valores de permissão são read_only e allow_edits. O padrão é read_only.

Status

  • queued: a execução foi aceita e está aguardando para começar.

  • running: o Buildprint está executando a tarefa.

  • completed: o agente ou a revisão foi concluído com sucesso.

  • error: a execução foi encerrada com um erro. Consulte lastError quando disponível.

Webhooks de conclusão

As solicitações para criar agentes e revisões de código podem incluir completionWebhookUrl. Quando esse parâmetro é fornecido, o Buildprint aguarda até que a execução chegue a um estado final e, em seguida, envia um payload JSON para o seu endpoint.

  • Execuções independentes de agentes enviam agent.completed.

  • Execuções de revisão de código enviam review.completed.

  • Se o seu webhook retornar uma resposta diferente de 2xx, o Buildprint tentará novamente a solicitação.

Respostas de erro

Todas as respostas de erro incluem uma string de erro. Algumas respostas também incluem um código legível por máquina e, nas verificações de plano, um motivo.

Os erros comuns incluem:

  • 401 Unauthorized: token bearer ausente ou inválido.

  • 402 api_access_required: o plano do workspace não inclui acesso à API.

  • 402 insufficient_paid_credits: foi solicitado um modelo hospedado pelo Buildprint, mas o workspace não tem créditos pagos suficientes.

  • 400 user_email_required: foi solicitado um modelo de provedor conectado sem userEmail.

  • 403 user_not_workspace_member: o userEmail fornecido não é membro do workspace.

  • 403 missing_provider_credentials: o usuário fornecido faz parte do workspace, mas não tem credenciais ativas para o provedor solicitado.

Isso foi útil?
Isso foi útil?