Integrações sem código

Tudo nestas páginas foi executado contra a produção de 2026-09-17. O workflow para n8n foi importado e executado num n8n real; os passos para Zapier e Make foram escritos de acordo com a documentação própria dessas ferramentas, e os pedidos que eles geram foram enviados exatamente dessa forma.

De onde vem o pedido

Isto determina qual chave é necessária.

• Zapier, Make e n8n enviam-no dos seus servidores. Precisas de uma chave “Apenas Servidor” com um âmbito de endpoints e um orçamento, como descrito abaixo. Instruções: Zapier, Make, n8n.
• Bubble também envia pedidos dos seus servidores, e a chave fica no cabeçalho, onde permanece: Bubble.
• FlutterFlow compila para uma aplicação que o utilizador mantém, por isso a chamada deve ser privada: FlutterFlow.
• Wix, Squarespace, Shopify, Webflow e Tilda mostram a página no navegador do visitante. Insere um widget, não uma chave: construtores de sites.
• WordPress faz a chamada a partir do teu próprio servidor. O plugin AstroWay trata da chave.

Cuidado

A chave pública pk_ não funciona com Zapier, Make ou n8n. Ela rejeita pedidos sem um origin da sua lista, e estas ferramentas não enviam um origin. De uma página de site, funciona apenas com um origin da sua lista.

Chave para automação

Qualquer pessoa que possa editar um Zap, script ou workflow vê a chave lá dentro. Por isso, dá a cada automação a sua própria chave e limita-a ao que ela faz.

1. No dashboard, abre Chaves de API e clica em Nova chave. Nomeia-a de acordo com a automação, por exemplo zapier-intake-form.
2. No campo Onde esta chave será usada?, deixa Apenas Servidor.
3. Copia a chave e guarda-a: o diálogo mostra-a na íntegra uma vez. Se a chave for perdida, clica em Atualizar chave no menu da chave: receberás uma nova, e a antiga deixará de funcionar.
4. No menu da chave, abre Âmbito dos endpoints e lista os caminhos que a automação invoca, um por linha: chart para um mapa natal, public/horoscope/* para horóscopos diários.
5. No mesmo menu, abre Definir orçamento e especifica quantos créditos esta chave pode gastar por ciclo.

Uma chamada fora da lista recebe 403 ENDPOINT_NOT_IN_SCOPE. Uma chave que esgotou o orçamento recebe 429 KEY_BUDGET_EXHAUSTED, mesmo que ainda haja créditos na conta, para que uma automação em loop pare no número especificado. Ambas as restrições funcionam em qualquer plano e estão descritas na secção Autenticação.

Envia o momento de nascimento, não o deslocamento

O formulário fornece a data, a hora do relógio e o local. Envia-os assim:

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": 50.45,
  "longitude": 30.52
}

• timezone é o nome do fuso horário, e o servidor encontra automaticamente o deslocamento do UTC que os relógios mantinham nessa data, incluindo o horário de verão. Kiev em 1990-05-15 estava em UTC+4, não +3: este é o tipo de erro que um deslocamento inserido manualmente pode causar. Envia auto para usar o fuso horário das coordenadas.
• Sem timezone e sem deslocamento, o mapa é calculado para UTC. A resposta ainda é 200, por isso verifica se o campo está mapeado.
• timezone vazio é rejeitado com 400, porque de outra forma um campo de formulário não preenchido seria lido como UTC.
• date no formato YYYY-MM-DD, time no formato HH:MM:SS. Se o formulário os armazena de forma diferente, usa a formatação de data na própria ferramenta.
• Os números podem vir como texto. "latitude": "50.45" é aceite, e é assim que a maioria dos campos de formulário os envia.
• A API não geocodifica. As coordenadas devem vir do formulário ou de um passo de geocodificação na ferramenta. O campo city é apenas um rótulo.

As regras para a conversão de fusos horários e datas anteriores a 1970 estão descritas em formatos de campo.

Como converter longitudes em signos

POST /v1/chart responde em graus ao longo do zodíaco, num invólucro { "ok": true, "data": { ... } }. O signo é igual a floor(longitude / 30), contando a partir de zero:

0 Carneiro, 1 Touro, 2 Gémeos, 3 Caranguejo, 4 Leão, 5 Virgem, 6 Balança, 7 Escorpião, 8 Sagitário, 9 Capricórnio, 10 Aquário, 11 Peixes.

Onde estão os três valores mais populares:

• Sol: entrada em data.planets com "name": "Sun", o primeiro.
• Lua: entrada em data.planets com "name": "Moon", o segundo.
• Ascendente: data.houses.ascendant.
• Deslocamento usado: data.input.timezoneOffset.

Para o exemplo acima: Sol 54.34, portanto Touro; Lua 296.39, Capricórnio; Ascendente 159.26, Virgem; deslocamento 4.

Quanto custa

• POST /v1/chart custa 20 créditos. A tabela completa está na página Custo dos endpoints.
• O mesmo pedido, enviado novamente dentro de cinco minutos, é devolvido da cache e não é cobrado. Uma execução de teste que repete o mesmo corpo não gasta o orçamento.
• GET /v1/public/horoscope/daily não gasta créditos. Sem chave ou com uma chave no plano Free, é contado para o limite de 30 pedidos por hora por endereço IP, e as plataformas de automação partilham os seus endereços entre clientes. Uma chave num plano pago tem o seu próprio limite.