Fixed Stars API
A mozgó bolygók mögött az asztrológia régebbi rétege a fix csillagokat olvassa – Regulus, Spica, Algol, Aldebaran és társaik. Ez az endpoint átvizsgál egy születési képletet szoros konjunkciók után ezekkel a fő csillagokkal, és visszaadja minden érintkezést a szögekkel, így beépítheted egy csillag híres jellemét az értelmezésbe.
Fixed Stars API
A megadott születési dátum, idő, UTC eltolás és koordináták alapján az endpoint kiszámítja a születési pontokat, majd végigjárja a Vivian Robson és Ptolemaiosz hagyományából származó fő fix csillagok katalógusát – a fényes, asztrológiailag súlyozott csillagokat, nem az egész eget. Minden csillagnál teszteli a születési pontokat konjunkcióra, és ha egy pont a szögben belül van, rögzíti az érintkezést a pontos szögértékkel. A data.stars alatt a kimenet a csillag-pont találatokat listázza: melyik csillag, melyik születési pont érintkezik, és milyen közel van az illeszkedés, így egy fél fokos konjunkció erősebbnek számít, mint egy a szög szélén. Csak konjunkciókat vesz figyelembe – a technika akkor tekint egy csillagot jelentősnek, ha egy képletpont rajta van, nem amikor a bolygók közti hosszúszögű szögeket alkotja. Ez a klasszikus források által szerencsésnek vagy veszélyesnek jelölt csillagokat hozza felszínre, készen állva, hogy a saját csillag-értelmezésedhez illeszd.
POST/v1/fixed-stars
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
}
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Használd ezt az endpointot, ha egy képlet-olvasás extra réteget igényel a megnevezett csillagokból – egy hagyományos vagy fix-csillag-tudatos értelmező, egy jelentéskészítő, ami kiemeli a feltűnő Algol vagy a királyi csillag Regulus érintkezést, vagy egy oktatóeszköz, ami megtanítja a legfényesebb csillagok legendáit. A szoros szög, csak-konjunkció tervezés a kimenetet fókuszáltan tartja: csak a megemlítésre érdemes néhány érintkezést kapsz, nem a zajt, így könnyű rövid kiemelt listaként megjeleníteni. Add meg ugyanazt a születési adatot, amit a natal-chart endpointnak küldtél, és a csillag-találatok össze fognak illeszkedni a bolygók és szögek pozícióival a képletedben, így megjegyezheted egy bolygó vagy szög mellékelt csillagát. Mivel a katalógus a hagyományosan jelentős csillagokra van szűrve, előre elkészített értelmező szöveget csatolhatsz mindenhez anélkül, hogy magadnak kellene a listát összeállítanod.
Notes
A csillagkatalógus a Vivian Robson és Ptolemaiosz által átadott kiválasztást követi – a fő asztrológiailag jelentős fix csillagokat, nem egy kimerítő égbolt felmérést. A születési pozíciókat és csillaghosszúságokat a Swiss Ephemeris (Astrodienst) motorja számítja ki a trópusi zodiákusban, és csak a szögen belüli konjunkciókat adja vissza.
Try the Fixed Stars API
Grab a key and make your first call in under a minute.