API есенціальних гідностей

За моментом і місцем народження ендпоінт визначає кожну планету за знаком і градусом, а потім оцінює її за птолемеївськими таблицями гідностей, які успадкувала середньовічна та елліністична практика. Він перевіряє п'ять есенціальних гідностей за спадом сили — обитель, екзальтацію, тригональне управління для секти карти, терм (межу), у який потрапляє градус, та лице (декан) — і дві есенціальні слабкості, вигнання й падіння, де планета стоїть навпроти своєї обителі чи екзальтації. Кожна планета отримує умовні бали гідності за кожну умову, яку виконує, слабкості віднімаються, а цифри зводяться у розбивку по тілах у data.dignities плюс загальносхемний totalScore. Результат каже не лише, у якому знаку планета, а наскільки вона там гідна чи послаблена, відрізняючи планету у власній обителі від тієї, що лише проходить крізь знак, на який не має жодних прав.

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

Звертайтеся до цього ендпоінта, коли інтерпретації потрібно зважувати силу планет, а не просто звітувати про положення — для традиційних та елліністичних читань карти, горарних помічників, оцінювання елекцій чи будь-якого інструмента, що ранжує, які планети справді тримають карту. Загальний бал дає швидкий скаляр для сортування чи порогів, а рядки по планетах дозволяють пояснити чому: ця Венера екзальтована й у тригоні, той Марс у падінні та вигнанні. Він природно поєднується з ендпоінтом natal-chart — візьміть звідти положення за знаком і градусом і передайте ті самі дані народження сюди, щоб накласти зважування гідностей зверху. Оскільки схема заснована на правилах і детермінована, той самий ввід завжди дає ті самі бали, що робить її надійною для функцій порівняння, які ранжують одну карту проти іншої.

Оцінювання слідує птолемеївській таблиці гідностей, як її пронесла традиційна та середньовічна західна астрологія; тригональне управління призначається за сектою карти (день чи ніч). Положення планет беруться з рушія Swiss Ephemeris (Astrodienst) на WASM у тропічному зодіаку, тож знак і градус, на яких тримаються гідності, точно збігаються з натальними ендпоінтами.