API de Profecções Anuais

O endpoint recebe os dados de nascimento e uma data alvo, conta os anos completos a partir do momento do nascimento e avança um signo inteiro a partir do ascendente para cada um deles. A resposta indica a idade contada, o índice zero-based do signo em que o ano cai, e o planeta que rege esse signo como lordOfYear, juntamente com o ascendente natal, MC, Sol e Lua para que possas renderizar o ano no mapa sem uma segunda chamada. O número da casa deriva directamente da idade: o ciclo tem doze anos, logo a casa profetizada é a idade módulo doze, mais um. Aos 36 anos volta à primeira casa e, portanto, ao signo do próprio ascendente, razão pela qual o mapa de exemplo, com ascendente a 169,97 graus em Virgem, indica signIndex 5 e Mercúrio como senhor desse ano. Como a contagem parte do momento do nascimento e não do calendário, o ano de profecção muda no aniversário e não em 1 de janeiro.

curl -X POST https://api.astroway.info/v1/profections \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "targetDate": "2026-05-15"
}'

{
  "ok": true,
  "data": {
    "age": 36,
    "signIndex": 5,
    "lordOfYear": "Mercury",
    "ascendant": 169.9680,
    "mc": 77.0743,
    "sun": 54.3760,
    "moon": 296.9047
  }
}

Usa as profecções quando precisas de uma camada de cronometragem que o leitor possa seguir sem uma efeméride. Cada ano tem um planeta regente, por isso uma previsão anual, um relatório de aniversário ou uma narrativa de IA podem ser construídos em torno de uma única afirmação clara em vez de uma tabela de trânsitos. Combina especialmente bem com trânsitos e retornos: encontra aqui o senhor do ano, depois vê o que acontece a esse planeta por trânsito, e tens a leitura clássica de dois passos em duas chamadas. Também se junta ao retorno solar, que cobre o mesmo ano de outra perspetiva. A técnica é deliberadamente grosseira. Diz-te que parte da vida está ativada e quem a governa, não o que acontece numa tarde específica, por isso trata-a como a estrutura onde penduras cronometragens mais finas.

Profecções de signo inteiro a partir do ascendente, um signo por ano completo, com os regentes de domicílio tradicionais a determinar o senhor do ano. As idades são contadas a partir do momento do nascimento, por isso o ano muda no aniversário. O ascendente natal, MC, Sol e Lua provêm do motor Swiss Ephemeris no zodíaco tropical e são devolvidos em graus.