Zapier

Um Zap que obtém a data, hora, fuso horário e coordenadas de nascimento de um gatilho, solicita um mapa à API e converte o Ascendente no nome de um signo. O pedido abaixo é enviado para produção exatamente como o passo o constrói; os passos no Zapier são escritos de acordo com a documentação do Zapier a partir de 2026-09-17.

É necessário um plano pago do Zapier

API by Zapier, Webhooks by Zapier e Formatter são aplicações premium. A documentação do Zapier indica que as três não estão disponíveis no plano Free, e o passo Lookup Table requer um plano Professional ou superior. No plano Free, usa Make ou n8n.

Primeiro, cria uma chave, conforme descrito na secção Chave para automação, com o escopo chart.

1. Coloca a chave na conexão

Os cabeçalhos inseridos no passo Webhooks by Zapier são armazenados no próprio passo e são visíveis para qualquer pessoa com acesso ao Zap. A API by Zapier mantém-nos na conexão.

1. Na página Apps, clica em + Add connection e seleciona API by Zapier.
2. Authentication type: Static Headers (API key).
3. Headers: X-Api-Key: e depois a tua chave, numa única linha.
4. Domain filter: api.astroway.info, para que a conexão não possa ser direcionada para outro lugar.

2. Solicita o mapa

Adiciona uma ação, seleciona API by Zapier, o evento API Request e a conexão.

• Method: POST.

• URL:

  https://api.astroway.info/v1/chart

• Body: O JSON abaixo com os campos do gatilho em vez dos valores.

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

Substitui cada valor pelo campo de gatilho correspondente e mantém as aspas à volta de cada um, incluindo os números. O Zapier insere o campo mapeado como texto simples e não adiciona as aspas, mas a API aceita "50.45" como um número. Não adiciones a chave nos Headers do passo: ela é fornecida pela conexão.

Testa o passo. A resposta correta começa com "ok": true, e data.input.timezoneOffset para o exemplo é 4: o deslocamento que Kiev tinha naquele dia.

3. Converte o Ascendente num signo

Dois passos Formatter.

Formatter, evento Numbers, transformação Spreadsheet-Style Formula. Fórmula:

FLOOR(ASCENDANT / 30)

onde ASCENDANT é substituído por data.houses.ascendant do passo 2. Para o exemplo, o resultado é 5.

Formatter, evento Utilities, transformação Lookup Table. A Lookup Key é o resultado da fórmula. Tabela:

Key	Value
0	Aries
1	Taurus
2	Gemini
3	Cancer
4	Leo
5	Virgo
6	Libra
7	Scorpio
8	Sagittarius
9	Capricorn
10	Aquarius
11	Pisces

Para o exemplo, o resultado é Virgo. Para obteres os nomes em português, insere-os na coluna Value.

O Sol e a Lua são calculados da mesma forma. São o primeiro e o segundo registo em data.planets, cada um com a sua própria longitude: por exemplo, 54.34 (Touro) e 296.39 (Capricórnio).

Se usas Webhooks by Zapier

Funciona, mas a chave está no passo, não na conexão. Para o mapa, seleciona o evento Custom Request: ele envia o campo Data exatamente como foi inserido, então o JSON acima será enviado sem alterações. Define o Method como POST, e em Headers adiciona X-Api-Key com a tua chave, e Content-Type com o valor application/json.

Quando o passo falha

• 400 INVALID_FIELD com timezone em details: o fuso horário mapeado está vazio, é uma abreviatura como EST ou não é um nome de fuso horário.
• 400 com date ou time em details: o formato do gatilho não é YYYY-MM-DD / HH:MM:SS; adiciona um passo Formatter para a data antes da chamada.
• 403 ENDPOINT_NOT_IN_SCOPE: o escopo da chave não inclui chart.
• 429 KEY_BUDGET_EXHAUSTED: a chave esgotou o seu orçamento; aumenta-o no dashboard.

A API não geocodifica. Se o gatilho tiver apenas um nome de local, as coordenadas devem vir do próprio gatilho ou de um serviço de geocodificação para o qual tenhas uma chave.