Pular para o conteúdo
AstroWay/api v2.356.0 · pt
todos os sistemas normais

Bubble

Last updated Ver como Markdown Configuração do agente

API Connector no Bubble envia chamadas a partir dos servidores do Bubble, por isso aqui é necessária uma chave “Só servidor”, e não pública. O pedido abaixo foi enviado para produção exatamente na forma em que a chamada o compõe; os passos no Bubble foram escritos de acordo com o guia do Bubble em 2026-09-17, e o próprio API Connector está incluído no plano gratuito.

Primeiro cria a chave, como descrito na secção Chave para automação, com a área chart.

No plugin API Connector clica em + New e preenche a coleção:

  • Collection name: AstroWay. O guia do Bubble avisa que o nome da coleção entra no código cliente da aplicação, por isso mantém‑o simples.
  • Authentication: Private key in header, o nome do cabeçalho X-Api-Key, o valor é a tua chave.
  • Se deixares None or self-handled, adiciona a chave em Shared headers for all calls usando o botão + Add a shared header e marca a caixa Private. Em ambos os casos a chave permanece no servidor.

Adiciona a chamada dentro da coleção e preenche‑a:

  • Call name: Natal chart.

  • Use as: Action para o workflow, Data, se a página lê os dados diretamente.

  • Method: POST.

  • URL:

    https://api.astroway.info/v1/chart
  • Body type: JSON.

  • Body: JSON abaixo. Os colchetes angulares são a sintaxe de parâmetro no Bubble, e cada um cria um registro sob o corpo.

{
"date": "<date>",
"time": "<time>",
"timezone": "<timezone>",
"latitude": "<latitude>",
"longitude": "<longitude>"
}

Debaixo do corpo desmarca a caixa Private de todos os cinco parâmetros, para que a aplicação possa defini‑los, e indica os valores da tabela como padrão. Depois clica em Initialize call.

ParâmetroValor para inicialização
date1990-05-15
time14:30:00
timezoneEurope/Kyiv
latitude50.45
longitude30.52

A inicialização é o que ensina o Bubble ao formato da resposta, e o guia pede para usar dados de exemplo, que são exatamente estes cinco valores. A resposta correta contém ok com o valor true e um objeto data com planets, houses e input.

Depois de adicionares ou renomeares um parâmetro, a inicialização tem de ser repetida: o esquema da resposta é guardado exatamente nesta etapa.

Depois da inicialização o Bubble mostra os campos da resposta com tipo e caixa de inclusão. Os três valores mais populares são:

  • Ascendente: data > houses > ascendant.
  • Sol: o primeiro registo data > planets, a sua longitude.
  • Lua: o segundo registo, a sua longitude.
  • Deslocamento usado: data > input > timezoneOffset, no exemplo acima é 4, porque Kiev nessa data tinha UTC+4.

O signo é a longitude dividida por 30 e arredondada para baixo, como índice numa lista de doze nomes. Na expressão: divide data's houses's ascendant por 30, pega a parte inteira e encontra o número no conjunto de opções ou na lista dos doze signos. Por exemplo, Ascendente 159.26 dá 5, ou seja, Virgem.

Marca na chamada a caixa Include errors in response & allow workflow actions to continue, se quiseres tratar falhas no workflow em vez de o parar. O Bubble indica que mudar esta opção após a inicialização altera o formato da resposta, por isso a inicialização tem de ser repetida.

  • 400 INVALID_FIELD com timezone em details: zona vazia, é uma abreviatura tipo EST ou não o nome da zona.
  • 400 com date ou time em details: formato não YYYY-MM-DD / HH:MM:SS. O operador :formatted as na data corrige isto para a chamada.
  • 403 ENDPOINT_NOT_IN_SCOPE: a área da chave não inclui chart.
  • 429 KEY_BUDGET_EXHAUSTED: a chave esgotou o seu orçamento; aumenta‑o no dashboard.