API godności esencjalnych
Godności esencjalne mierzą, jak komfortowo każda planeta siedzi w znaku i stopniu, który zajmuje. Ten endpoint przepuszcza każde ciało przez pięciostopniowy schemat tradycyjny — władztwo, egzaltację, triplicytet, term i twarz — wraz z dwoma upadkami i zwraca zarówno rozbicie per planeta, jak i pojedynczy ważony wynik łączny.
API godności esencjalnych
Mając moment i miejsce urodzenia, endpoint lokalizuje każdą planetę według znaku i stopnia, a następnie ocenia ją względem tablic godności ptolemejskich, które odziedziczyła praktyka średniowieczna i hellenistyczna. Sprawdza pięć godności esencjalnych w malejącej sile — władztwo domicylu, egzaltację, władztwo triplicytetu dla sekty horoskopu, term lub granicę, w którą wpada stopień, oraz twarz lub dekan — a także dwa upadki esencjalne, wygnanie i upadek, gdzie planeta siedzi naprzeciw swojego władztwa lub egzaltacji. Każda planeta otrzymuje konwencjonalne punkty godności za każdy spełniony warunek, upadki odejmują, a wartości zsumowują się w rozbicie per ciało pod data.dignities plus ogólny dla horoskopu totalScore. Wynik mówi nie tylko, w którym znaku jest planeta, ale jak godna lub osłabiona tam jest, odróżniając planetę we własnym domu od takiej, która jedynie przechodzi przez znak, do którego nie ma żadnych praw.
POST/v1/essential-dignities
curl -X POST https://api.astroway.info/v1/essential-dignities \
-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": {
"dignities": [
{
"planet": "Venus",
"rulership": false,
"exaltation": true,
"triplicity": true,
"score": 7
}
],
"totalScore": 12
}
} Parametry
| name | type | Wymagane | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | tak | Birth date. |
| time | string (HH:MM:SS) | tak | Local clock time at birth. |
| timezoneOffset | number (hours) | tak | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | tak | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | tak | Birth-place longitude, decimal degrees (east positive). |
Kiedy używać
Sięgnij po ten endpoint zawsze, gdy interpretacja musi ważyć siłę planetarną, a nie tylko raportować pozycje — czytelnicy horoskopów tradycyjnych i hellenistycznych, pomocnicy horarni, ocena elekcyjna lub każde narzędzie, które rangował, które planety naprawdę niosą horoskop. Wynik łączny daje szybki skalar do sortowania lub progowania, podczas gdy wiersze per planeta pozwalają wyjaśnić dlaczego: ta Wenus jest egzaltowana i w triplicytecie, tamten Mars jest w upadku i wygnaniu. Łączy się naturalnie z endpointem natal-chart — weź pozycje znaków i stopni stamtąd i przekaż te same dane urodzeniowe tutaj, aby nałożyć na wierzch ważenie godności. Ponieważ schemat jest oparty na regułach i deterministyczny, to samo wejście zawsze daje te same wyniki, co czyni go niezawodnym dla funkcji porównawczych rangujących jeden horoskop względem drugiego.
Uwagi
Ocena podąża za tablicą godności ptolemejskich przeniesioną w astrologię tradycyjną i średniowieczną zachodnią; władztwo triplicytetu przypisywane jest według sekty horoskopu (dzień lub noc). Pozycje planetarne pochodzą z silnika WASM Swiss Ephemeris (Astrodienst) w zodiaku tropikalnym, więc znak i stopień, na których spoczywają godności, dokładnie odpowiadają endpointom natalnym.
Wypróbuj API Godności esencjalne
Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.