Vaste Sterren API
Bewegende planeten ten spijt, leest de oudere laag van de astrologie de vaste sterren - Regulus, Spica, Algol, Aldebaran en hun soortgenoten. Dit endpoint scant een geboortehoroscoop op nauwe conjuncties met die belangrijke sterren en geeft elke contactpunt terug met zijn orb, zodat je de vermeende karakteristiek van een ster kunt verwerken in een reading.
Vaste Sterren API
Op basis van de geleverde geboortedatum, tijd, UTC-offset en coördinaten berekent het endpoint de natal punten en doorloopt vervolgens de catalogus van belangrijke vaste sterren uit de Vivian Robson en Ptolemy traditie - de heldere, astrologisch gewogen sterren in plaats van de hele hemel. Voor elke ster test het de natal punten op een conjunctie, en waar er een binnen de orb valt, registreert het het contactpunt samen met de exacte scheidingsafstand. De output onder data.stars is een lijst van ster-punt treffers: welke ster, welk natal punt raakt het, en hoe dicht de uitlijning is, zodat een halvegraad conjunctie krachtiger wordt gelezen dan een aan de rand van de orb. Alleen conjuncties worden overwogen - de techniek behandelt een ster als significant wanneer een horoscoop punt erop ligt, niet wanneer het de longitudinale hoek vormt die planeten met elkaar maken. Dit brengt de benoemde sterren naar voren die klassieke bronnen als gelukkig of gevaarlijk hebben aangemerkt, klaar om te worden gekoppeld aan je eigen ster-betekenis kopie.
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
Gebruik dit endpoint wanneer een horoscoop lezing de extra textuur van benoemde sterren wil - een traditionele of vaste-sterren-bewuste interpreter, een rapportgenerator die een opvallend Algol of koningsster Regulus contact markeert, of een educatief instrument dat de verhalen achter de helderste sterren leert. De nauwe-orb, alleen-conjunctie ontwerp houdt de output gefocust: je krijgt de handvol contactpunten die het vermelden waard zijn in plaats van ruis, wat het gemakkelijk maakt om weer te geven als een kort, gemarkeerd lijstje. Voer dezelfde geboortegegevens in die je naar het natal-chart endpoint hebt gestuurd en de ster treffens zullen uitlijnen met de planetaire en hoekposities die al in je horoscoop staan, zodat je een planeet of hoek kunt annoteren met zijn gelokaliseerde ster. Omdat de catalogus is samengesteld uit traditioneel significante sterren, kun je voorbereide interpretatieve tekst aan elke toevoegen zonder de lijst zelf samen te stellen.
Notes
De sterrencatalogus volgt de selectie die is overgeleverd via Vivian Robson en Ptolemy - de belangrijkste astrologisch significante vaste sterren, niet een uitputtende hemelverkenning. Natal posities en sterrengolflengtes worden berekend door de Swiss Ephemeris (Astrodienst) engine in de tropische dierenriem, en alleen conjuncties binnen de orb worden geretourneerd.
Try the Vaste Sterren API
Grab a key and make your first call in under a minute.