Versões

Sincronizar uma versão

Agenda uma sincronização para um branch do Bubble e aguarda brevemente pela conclusão. Retorna HTTP 200 quando a sincronização é concluída ou falha dentro da janela de espera, e HTTP 202 quando a sincronização ainda está em execução e deve ser consultada via GET /api/public/v1/versions?appId=...&versionId=....

POST /api/public/v1/versions/sync

Sincronizar uma versão

curl --request POST \
  --url 'https://api.buildprint.ai/api/public/v1/versions/sync' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "key": "value"
}'
{
  "ok": true,
  "status": "in_progress",
  "stage": "pending",
  "versionId": "<string>",
  "version": "<string>",
  "appVersion": "<string>",
  "message": "<string>",
  "error": "<string>"
}

A sincronização foi concluída ou falhou durante a janela de espera.

Authorizations

  • Authorization string obrigatório header

    Token da API REST do workspace prefixado com bp_

Request Body

application/json
  • appId string obrigatório

    ID do app Bubble para o projeto a ser sincronizado.

  • version string obrigatório

    Seletor de branch do Bubble para sincronizar. Aceita um ID de branch ou rótulo de exibição.

Response

application/json
  • ok boolean

    Sempre true quando a solicitação foi aceita.

  • status string enum enum

    Status de sincronização de alto nível derivado do estágio. Allowed values: in_progress, completed, failed.

  • stage string enum enum

    Estágio do ciclo de vida da versão sincronizada. Allowed values: pending, stored, indexing, completed, failed.

  • versionId string

    ID exato da versão sincronizada no Buildprint criada para esta execução.

  • version string

    ID canônico do branch do Bubble que foi sincronizado.

  • appVersion string

    Alias da versão para compatibilidade.

  • message string

    Orientação de status legível por humanos.

  • error string

    Mensagem de falha quando o status da sincronização é failed.