API синастрії

Ендпоінт синастрії обчислює обидві натальні карти незалежно, а потім накладає їх, щоб знайти міжкартні аспекти: кожен кутовий зв’язок, де планета карти A зустрічає планету карти B у межах орбіса. Кожен перехресний аспект повертається з назвами обох тіл, типом аспекту (з’єднання, секстиль, квадрат, тригон, опозиція та мінорні кути), точним орбісом і напрямком контакту — тож ви знаєте, чия Венера утворює тригон до чийого Марса. Повні набори планет для обох суб’єктів повертаються поруч, тож можна намалювати бі-віл або передати дані в калькулятор сумісності без другого запиту.

curl -X POST https://api.astroway.info/v1/synastry \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "chart1": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 },
    "chart2": { "date": "1985-11-03", "time": "08:15:00", "timezoneOffset": 2, "latitude": 48.46, "longitude": 35.04 }
  }'

{
  "ok": true,
  "data": {
    "crossAspects": [
      { "planet1": "Venus", "planet2": "Mars", "type": "trine", "orb": 0.8, "direction": "A→B" }
    ],
    "chart1": { "input": { ... }, "planets": [ ... ] },
    "chart2": { "input": { ... }, "planets": [ ... ] }
  }
}

Це опорний ендпоінт для застосунків знайомств і метчмейкінгу, продуктів зі звітами про стосунки та будь-якої функції, що відповідає на питання «як ці двоє пов’язані?». Поєднайте його з нашим хелпером оцінки сумісності, щоб перетворити «сирі» перехресні аспекти на єдиний відсоток, або передайте сітку в LLM для текстового опису стосунків. Оскільки обидві карти повертаються повністю, один виклик синастрії замінює три (дві натальні карти плюс накладання) — обчисліть один раз і закешуйте за двома моментами народження. Метод за Робертом Хендом і Стівеном Арройо; композитна карта та середина Девісона мають власні ендпоінти, коли потрібна єдина об’єднана карта замість накладання.

Перехресні аспекти використовують ту саму політику орбісів, що й натальна сітка аспектів. Обидва суб’єкти приймають повний набір параметрів /v1/chart, зокрема систему домів і зміщення часового поясу для кожного. Синастрія — ендпоінт Tier 3 (дві карти + скан накладання); кешуйте активно, адже результат повністю детермінований для заданої пари моментів народження.