API натальної карти

Ендпоінт натальної карти переводить дату народження, місцевий час і зміщення UTC у точний юліанський день, після чого запитує в рушія Swiss Ephemeris геоцентричну довготу, широту та швидкість кожного тіла — десять класичних планет, місячні вузли, Хірон і Чорну Місяцю Ліліт. Він обчислює Асцендент і Середину неба за широтою та довготою місця народження, ділить доми за обраною системою, призначає кожній планеті знак і дім та будує повну сітку аспектів зі статусом «зближення/розходження» й точними орбісами. Ретроградність визначається за швидкістю тіла, а секта карти (денне чи нічне народження) повертається, щоб подальша інтерпретація правильно зважувала бенефіки й малефіки.

curl -X POST https://api.astroway.info/v1/chart \
  -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,
    "houseSystem": "P"
  }'

{
  "ok": true,
  "data": {
    "planets": [
      { "name": "Sun", "longitude": 54.23, "sign": "Taurus", "house": 10, "retrograde": false },
      { "name": "Moon", "longitude": 282.7, "sign": "Capricorn", "house": 6 }
    ],
    "houses": { "ascendant": 160.4, "mc": 70.1, "cusps": [160.4, 190.3, ...] },
    "aspects": [ { "body1": "Sun", "body2": "Moon", "type": "trine", "orb": 1.2 } ]
  }
}

Використовуйте цей ендпоінт, коли потрібен структурний каркас гороскопа: віджет натальної карти, натальний звіт, онбординг, що персоналізує контент за Сонцем/Місяцем/Асцендентом, або ШІ-агент, якому потрібні «сирі» позиції перед інтерпретацією. Це передумовний виклик для синастрії, транзитів, прогресій і більшості типів звітів — обчисліть карту один раз, закешуйте JSON і передавайте його у важчі ендпоінти замість повторного розрахунку. Оскільки відповідь — це чисті дані (без тексту й зображень), вона легко лягає в будь-який стек: рендеріть самостійно, передайте в LLM або в наші ендпоінти SVG-рендера.

Налаштування за замовчуванням відповідають загальноприйнятій західній традиції: тропічний зодіак, доми Placidus, «велика трійка» Сонце–Місяць–Асцендент. Рушій — Swiss Ephemeris (Astrodienst), скомпільований у WASM і спільний із браузерним калькулятором, тож сервер і клієнт збігаються до кутової секунди. За полярним колом, де Placidus невизначений, доми відкочуються на систему Porphyry.