# API синастрії

Порівняйте дві натальні карти одним запитом і отримайте сітку перехресних аспектів, що живить будь-яку функцію сумісності — хто з ким утворює аспект, під яким кутом, з яким орбісом і в якому напрямку. На вході дві карти — на виході зв’язок між ними.

## Ендпоінт

`POST /v1/synastry`

- Operation ID: `synastry`
- Вартість: 50 кредитів (тариф 3)
- Типова латентність: 250 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/synastry/

## Що обчислює

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

## Коли використовувати

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

## Параметри запиту

| Parameter | Type | Required | Description |
|---|---|---|---|
| `chart1` | object | yes | First subject — same shape as /v1/chart (date, time, timezoneOffset, latitude, longitude). |
| `chart2` | object | yes | Second subject — identical shape. |
| `chart1.name / chart2.name` | string | no | Optional labels echoed back so you can tell the two subjects apart in the response. |

## Приклад запиту

```bash
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 }
  }'
```

## Приклад відповіді

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

## Нотатки

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

## Пов’язані техніки

- https://api.astroway.info/astrology-api/natal-chart/
- https://api.astroway.info/astrology-api/composite-chart/

---

Повна машиночитана специфікація: https://api.astroway.info/v1/openapi.json
Інструкції для агента: https://api.astroway.info/AGENTS.md