API de aspetos de declinação

A partir da data de nascimento, hora, desvio UTC e coordenadas, o endpoint calcula a declinação de cada corpo — o quão a norte ou a sul do equador celeste se situa, fora do plano da eclíptica em que a longitude é medida — e depois compara essas declinações entre corpos. Onde dois corpos partilham a mesma declinação do mesmo lado do equador, regista um paralelo, o equivalente em declinação de uma conjunção; onde partilham a mesma declinação em lados opostos, regista um contraparalelo, o equivalente de uma oposição. Cada contacto é devolvido em data.parallels com os corpos envolvidos. O endpoint faz também emergir o contexto fora-dos-limites — quando a declinação de um corpo excede a máxima do Sol, levando-o para além da faixa que o Sol alguma vez alcança, uma condição tradicionalmente lida como o planeta a operar sem a sua contenção habitual. Isto dá-lhe uma camada de contacto que a longitude pura ignora por completo: dois planetas sem qualquer aspeto longitudinal podem ainda assim estar travados num paralelo apertado.

curl -X POST https://api.astroway.info/v1/parallel-aspects \
  -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
}'

{
  "ok": true,
  "data": {
    "parallels": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "contra-parallel",
        "orb": 0.49
      }
    ]
  }
}

Use este endpoint quando um motor de aspetos não deva parar na eclíptica — um analisador de mapas sério, uma ferramenta de sinastria ou de trânsitos que queira a camada de declinação, ou um relatório que explique por que dois planetas parecem ligados apesar de não formarem qualquer aspeto em longitude. Os paralelos e contraparalelos são exatamente os contactos que uma grelha apenas de longitude descarta, pelo que adicioná-los preenche uma lacuna real em vez de duplicar a saída de aspetos do natal-chart. O indicador de fora-dos-limites é útil de forma independente: marca os planetas que a tradição trata como a operar sem freio, o que faz um destaque limpo num relatório de mapa. Envie os mesmos dados de nascimento que usou noutro lado e os contactos de declinação referir-se-ão aos mesmos corpos que os seus aspetos de longitude, permitindo apresentar ambas as grelhas como duas leituras de um só mapa.

Os paralelos e contraparalelos seguem a doutrina tradicional de declinação, tratando os contactos de igual declinação como os análogos da conjunção e da oposição; a leitura de fora-dos-limites baseia-se no trabalho de Kt Boehrer. As declinações são calculadas pelo motor WASM do Swiss Ephemeris (Astrodienst) na estrutura tropical, sobre os mesmos corpos que os endpoints natais baseados em longitude.