Bubble
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.
1. Cria a coleção
Seção intitulada “1. Cria a coleção”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.
2. Adiciona a chamada
Seção intitulada “2. Adiciona a chamada”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âmetro | Valor para inicialização |
|---|---|
date | 1990-05-15 |
time | 14:30:00 |
timezone | Europe/Kyiv |
latitude | 50.45 |
longitude | 30.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.
3. Lê a resposta
Seção intitulada “3. Lê a resposta”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 sualongitude. - 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_FIELDcomtimezoneemdetails: zona vazia, é uma abreviatura tipoESTou não o nome da zona.400comdateoutimeemdetails: formato nãoYYYY-MM-DD/HH:MM:SS. O operador:formatted asna data corrige isto para a chamada.403 ENDPOINT_NOT_IN_SCOPE: a área da chave não incluichart.429 KEY_BUDGET_EXHAUSTED: a chave esgotou o seu orçamento; aumenta‑o no dashboard.