API de estrelas fixas

A partir da data de nascimento, hora, desvio UTC e coordenadas fornecidas, o endpoint calcula os pontos natais e depois percorre o catálogo de estrelas fixas maiores extraído da tradição de Vivian Robson e Ptolomeu — as estrelas brilhantes e astrologicamente ponderadas, e não o céu inteiro. Para cada estrela, testa os pontos natais em busca de uma conjunção e, onde uma cai dentro do orbe, regista o contacto juntamente com o orbe exato de separação. A saída em data.stars é uma lista de contactos estrela-a-ponto: que estrela, que ponto natal toca e quão próximo está o alinhamento, de modo que uma conjunção de meio grau se lê como mais potente do que uma no limite do orbe. Apenas as conjunções são consideradas — a técnica trata uma estrela como significativa quando um ponto do mapa assenta sobre ela, não quando forma os ângulos longitudinais que os planetas fazem entre si. Isto faz emergir as estrelas nomeadas que as fontes clássicas singularizaram como afortunadas ou perigosas, prontas a serem associadas ao seu próprio texto sobre o significado das estrelas.

curl -X POST https://api.astroway.info/v1/fixed-stars \
  -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": {
    "stars": [
      {
        "star": "Regulus",
        "point": "Mercury",
        "orb": 0.4
      },
      {
        "star": "Algol",
        "point": "Mars",
        "orb": 1.1
      }
    ]
  }
}

Use este endpoint quando uma leitura de mapa quiser a textura adicional das estrelas nomeadas — um intérprete tradicional ou atento às estrelas fixas, um gerador de relatórios que assinala um marcante contacto com Algol ou com a estrela real Régulo, ou uma ferramenta educativa que ensina a tradição por trás das estrelas mais brilhantes. O desenho de orbe apertado e apenas de conjunções mantém a saída focada: obtém o punhado de contactos que vale a pena mencionar em vez de ruído, o que facilita renderizar como uma curta lista em destaque. Alimente-o com os mesmos dados de nascimento que enviou ao endpoint natal-chart e os contactos com estrelas alinhar-se-ão com as posições planetárias e angulares já no seu mapa, permitindo anotar um planeta ou ângulo com a estrela com ele co-localizada. Como o catálogo é curado para as estrelas tradicionalmente significativas, pode anexar texto interpretativo preparado a cada uma sem curar a lista você mesmo.

O catálogo de estrelas segue a seleção transmitida através de Vivian Robson e Ptolomeu — as estrelas fixas astrologicamente significativas maiores, não um levantamento exaustivo do céu. As posições natais e as longitudes das estrelas são calculadas pelo motor WASM do Swiss Ephemeris (Astrodienst) no zodíaco tropical, e apenas as conjunções dentro do orbe são devolvidas.