# API композитної карти

Зливає дві натальні карти в одну. Серединний композит бере кожну пару планет і обидва набори кутів, знаходить середину кожного й повертає одну похідну карту, що моделює стосунки як окрему сутність. Дві карти на вхід, один композит на вихід, JSON.

## Ендпоінт

`POST /v1/composite`

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

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

Ендпоінт композиту приймає дві повні натальні карти й будує з їхніх серединних точок третю карту. Для кожного тіла він поєднує дві довготи й обчислює середину по коротшій дузі, роблячи те саме для двох Асцендентів і двох Середин неба, тож композит несе власні кути й каркас домів, а не запозичує їх в одного з партнерів. За цими серединними позиціями він призначає знаки й доми та обчислює повну внутрішню сітку аспектів із позначками наближення й розходження та точними орбісами. Результат — це не порівняння двох людей, а портрет самого зв'язку: де лягають Сонце, Місяць і кути стосунків, які аспекти їх структурують і як їхні енергії розподіляються по домах. Кожна карта партнера подається в тій самій формі, що й стандартна натальна, тож можна спершу обчислити дві наталки й передати їх безпосередньо.

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

Звертайтеся до композиту, коли одиницею інтересу є стосунки, а не окремі люди — функція «карта пари», звіт про «хімію двох» чи ШІ-сценарій, якому потрібно змоделювати стосунки як єдиний суб'єкт перед інтерпретацією. Він доповнює синастрію: синастрія накладає планети однієї людини на іншу, щоб показати, як вони торкаються, тоді як композит згортає обидві в одну похідну карту, щоб показати, чим є самі стосунки. Використовуйте його для романтичних пар, ділових партнерств чи будь-якого двостороннього зв'язку, де єдина карта читається чіткіше за сітку перехресних аспектів. Якщо ж вам потрібен саме метод серединної точки часу й простору — реальна карта на середину в часі та місці — використайте натомість ендпоінт Davison.

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `chart1` | object | yes | First partner's birth data as an object with the same shape as a natal chart. |
| `chart2` | object | yes | Second partner's birth data as an object with the same shape as a natal chart. |

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

```bash
curl -X POST https://api.astroway.info/v1/composite \
  -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": {
    "input": {},
    "planets": [
      {
        "name": "Sun",
        "longitude": 117.3,
        "sign": "Cancer",
        "house": 7
      }
    ],
    "houses": {
      "ascendant": 12.4,
      "mc": 280,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      {
        "planet1": "Sun",
        "planet2": "Venus",
        "type": "sextile",
        "orb": 0.6
      }
    ]
  }
}
```

## Нотатки

Це серединний композит: кожна позиція є арифметичною серединою відповідної пари, включно з кутами, тож карта має справжні власні куспіди. Він відрізняється від карти серединної точки часу й простору Davison, яка будується на серединний момент і місце та живе на окремому ендпоінті /davison. Скрізь тропічний зодіак і Swiss Ephemeris.

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

- https://api.astroway.info/astrology-api/synastry/
- https://api.astroway.info/astrology-api/secondary-progressions/

---

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