API de Cartas Harmónicas

Envia os dados de nascimento e um número harmónico de 2 a 36. O endpoint calcula as posições natais, multiplica cada longitude pelo harmónico, reduz módulo 360 e devolve a carta resultante com a sua própria grelha de aspetos. O exemplo torna a aritmética visível: o Sol natal a 54.3760 graus, levado ao quinto harmónico, volta como 271.8801, que é 54.3760 vezes cinco com três círculos completos removidos. Como a multiplicação comprime o círculo, um aspeto natal de 360 dividido por n torna-se uma conjunção no enésimo harmónico. Quintis a 72 graus empilham-se no quinto, séptis a cerca de 51.4 graus empilham-se no sétimo, e o nono é o análogo ocidental do navamsa. A resposta traz os planetas harmónicos, a estrutura das casas e a grelha completa de aspetos calculada sobre as posições harmónicas, por isso a carta é utilizável diretamente sem precisar de uma segunda passagem.

curl -X POST https://api.astroway.info/v1/harmonics \
  -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,
  "houseSystem": "P",
  "harmonic": 5
}'

{
  "ok": true,
  "data": {
    "harmonicNumber": 5,
    "planets": [
      {
        "id": 0,
        "name": "Sun",
        "longitude": 271.8801,
        "isRetrograde": false
      }
    ],
    "houses": { "system": "P", "cusps": [] },
    "aspects": []
  }
}

Recorre aos harmónicos quando a carta natal não mostra o padrão que suspeitas estar lá. As famílias de aspetos menores são a razão habitual: quintis e séptis são fáceis de perder numa grelha de longitudes e óbvios quando o harmónico os empilha em conjunções. Serve para uma ferramenta de investigação, um analisador avançado de cartas, ou uma funcionalidade que oferece ao utilizador experiente algo além da roda natal. O quinto é o ponto de entrada comum para padrões criativos e de talento, o sétimo para a família inspiracional e compulsiva, o nono para a leitura de casamento e dharma que partilha com a prática védica. Envia os mesmos dados de nascimento da tua chamada natal e o harmónico referir-se-á aos mesmos corpos, por isso ambas as cartas podem ser apresentadas lado a lado como duas vistas de uma mesma natividade.

As longitudes são multiplicadas pelo harmónico e reduzidas módulo 360; a grelha de aspetos é depois calculada sobre as posições harmónicas em vez de ser transportada da carta natal. São aceites harmónicos de 2 a 36. As posições vêm do motor Swiss Ephemeris no zodíaco tropical, com os mesmos corpos e sistema de casas dos endpoints natais.