API gwiazd stałych

Na podstawie dostarczonej daty urodzenia, godziny, przesunięcia UTC i współrzędnych endpoint oblicza punkty natalne, a następnie przechodzi katalog głównych gwiazd stałych zaczerpnięty z tradycji Viviana Robsona i Ptolemeusza — jasnych, astrologicznie ważonych gwiazd, a nie całego nieba. Dla każdej gwiazdy testuje punkty natalne pod kątem koniunkcji, a tam gdzie któraś wpada w granice orbu, zapisuje kontakt wraz z dokładnym orbem separacji. Wynik pod data.stars to lista trafień gwiazda–punkt: która gwiazda, którego punktu natalnego dotyka i jak ścisłe jest dopasowanie, tak że koniunkcja w pół stopnia czyta się jako potężniejsza niż ta na skraju orbu. Pod uwagę brane są wyłącznie koniunkcje — technika traktuje gwiazdę jako znaczącą, gdy punkt horoskopu siedzi na niej, a nie gdy tworzy kąty długościowe, jakie planety tworzą między sobą. Wydobywa to nazwane gwiazdy, które źródła klasyczne wyróżniały jako pomyślne lub niebezpieczne, gotowe do dopasowania do twojej własnej treści o znaczeniu gwiazd.

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

Użyj tego endpointu, gdy odczyt horoskopu chce dodatkowej faktury nazwanych gwiazd — interpretatora tradycyjnego lub świadomego gwiazd stałych, generatora raportów oznaczającego uderzający kontakt z Algolem lub królewską gwiazdą Regulusem, lub narzędzia edukacyjnego uczącego wiedzy stojącej za najjaśniejszymi gwiazdami. Konstrukcja oparta na ścisłym orbie i wyłącznie koniunkcjach utrzymuje wynik skupiony: dostajesz garść kontaktów wartych wspomnienia, a nie szum, co ułatwia wyrenderowanie ich jako krótkiej, wyróżnionej listy. Zasil go tymi samymi danymi urodzeniowymi, które wysłałeś do endpointu natal-chart, a trafienia gwiazd ułożą się w jednej linii z pozycjami planet i kątów już w twoim horoskopie, pozwalając ci zaadnotować planetę lub kąt jej współlokowaną gwiazdą. Ponieważ katalog jest wyselekcjonowany do gwiazd tradycyjnie znaczących, możesz dołączyć przygotowany tekst interpretacyjny do każdej z nich bez samodzielnego kuratorowania listy.

Katalog gwiazd podąża za selekcją przekazaną przez Viviana Robsona i Ptolemeusza — głównymi astrologicznie znaczącymi gwiazdami stałymi, a nie wyczerpującym przeglądem nieba. Pozycje natalne i długości gwiazd są obliczane przez silnik WASM Swiss Ephemeris (Astrodienst) w zodiaku tropikalnym, a zwracane są wyłącznie koniunkcje w granicach orbu.