API Stelle Fisse

Dalla data di nascita, ora, offset UTC e coordinate fornite, l'endpoint calcola i punti natali e poi attraversa il catalogo delle principali stelle fisse tratto dalla tradizione di Vivian Robson e Ptolemy – le stelle luminose e astrologicamente ponderate, non l'intero cielo. Per ogni stella verifica i punti natali alla ricerca di una congiunzione e, se cade dentro l'orbe, registra il contatto con l'esatto valore dell'orbe di separazione. L'output in data.stars è una lista di corrispondenze stella-punto: quale stella, quale punto natale tocca e quanto è vicina l'allineamento, così una congiunzione di mezzo grado appare più potente di una ai margini dell'orbe. Si considerano solo le congiunzioni – la tecnica tratta una stella come significativa quando un punto della carta è su di essa, non quando forma gli angoli longitudinali che i pianeti fanno tra loro. Questo mette in evidenza le stelle nominate che le fonti classiche hanno indicato come fortunate o pericolose, pronte per essere abbinate al tuo testo interpretativo della stella.

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
      }
    ]
  }
}

Usa questo endpoint quando una lettura della carta vuole aggiungere la texture extra delle stelle nominate – un interprete tradizionale o esperto di stelle fisse, un generatore di report che segnala un contatto impressionante con Algol o la regale Regulus, o uno strumento educativo che insegna il folklore dietro le stelle più luminose. Il design a congiunzioni strette e solo congiunzioni mantiene l'output focalizzato: ottieni solo i pochi contatti degni di nota invece di rumore, il che lo rende facile da mostrare come una breve lista evidenziata. Fornisci gli stessi dati di nascita che hai inviato all'endpoint natal-chart e i contatti stellari si allineeranno con le posizioni planetarie e angolari già nella tua carta, permettendoti di annotare un pianeta o un angolo con la sua stella co-locata. Poiché il catalogo è curato per le stelle tradizionalmente significative, puoi allegare un testo interpretativo preparato a ciascuna senza dover curare la lista tu stesso.

Il catalogo delle stelle segue la selezione tramandata da Vivian Robson e Ptolemy – le principali stelle fisse astrologicamente significative, non un'indagine completa del cielo. Le posizioni natali e le longitudini stellari sono calcolate dal Swiss Ephemeris (Astrodienst) motore nello zodiacale tropicale, e vengono restituite solo le congiunzioni entro l'orbe.