Fixed-Stars-API

Aus dem übergebenen Geburtsdatum, der Zeit, dem UTC-Offset und den Koordinaten berechnet der Endpunkt die natalen Punkte und durchläuft dann den Katalog der Hauptfixsterne, der aus der Tradition von Vivian Robson und Ptolemy geschöpft ist — die hellen, astrologisch gewichteten Sterne statt des ganzen Himmels. Für jeden Stern prüft er die natalen Punkte auf eine Konjunktion, und wo eine innerhalb des Orbs fällt, verzeichnet er den Kontakt zusammen mit dem exakten Orb der Trennung. Die Ausgabe unter data.stars ist eine Liste von Stern-zu-Punkt-Treffern: welcher Stern, welchen natalen Punkt er berührt und wie eng die Ausrichtung ist, sodass sich eine Halbgrad-Konjunktion als wirkmächtiger liest als eine am Rand des Orbs. Es werden nur Konjunktionen berücksichtigt — die Technik behandelt einen Stern als bedeutsam, wenn ein Horoskoppunkt auf ihm sitzt, nicht wenn er die ekliptikalen Winkel bildet, die Planeten untereinander bilden. Dies bringt die benannten Sterne zum Vorschein, die klassische Quellen als glücklich oder gefährlich hervorhoben, bereit, mit Ihrem eigenen Text zur Sternbedeutung abgeglichen zu werden.

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

Verwenden Sie diesen Endpunkt, wenn eine Horoskopdeutung die zusätzliche Textur benannter Sterne möchte — ein traditioneller oder fixstern-bewusster Deuter, ein Berichtsgenerator, der einen markanten Algol- oder Königsstern-Regulus-Kontakt kennzeichnet, oder ein Lerntool, das die Überlieferung hinter den hellsten Sternen vermittelt. Das eng-orbige, ausschließlich-Konjunktionen-Design hält die Ausgabe fokussiert: Sie erhalten die Handvoll erwähnenswerter Kontakte statt Rauschen, was es leicht macht, sie als kurze, hervorgehobene Liste zu rendern. Speisen Sie ihm dieselben Geburtsdaten ein, die Sie an den natal-chart-Endpunkt gesendet haben, und die Sterntreffer reihen sich mit den Planeten- und Achsenpositionen ein, die bereits in Ihrem Horoskop sind, sodass Sie einen Planeten oder eine Achse mit ihrem mitstehenden Stern annotieren können. Da der Katalog auf die traditionell bedeutsamen Sterne kuratiert ist, können Sie an jeden vorbereiteten Deutungstext anhängen, ohne die Liste selbst kuratieren zu müssen.

Der Sternkatalog folgt der Auswahl, die durch Vivian Robson und Ptolemy überliefert wurde — die wichtigsten astrologisch bedeutsamen Fixsterne, keine erschöpfende Himmelserfassung. Natale Positionen und Sternlängen werden von der Swiss-Ephemeris-(Astrodienst-)WASM-Engine im tropischen Tierkreis berechnet, und es werden nur Konjunktionen innerhalb des Orbs zurückgegeben.