# Dating & Compatibility API — сумісність одним викликом

Для застосунків знайомств: `POST /v1/match/score` повертає **усе потрібне одним викликом** — замість того щоб робити synastry + attraction + власну логіку прапорців окремо. Поверх — повний набір сумісності (synastry, ведична Ashtakoot, composite/Davison, AI-наратив).

## `/match/score` — агрегат для dating

Той самий вхід `chart1` + `chart2`, що й `/synastry`. Один виклик — Tier 3.

```bash
curl -X POST https://api.astroway.info/v1/match/score \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chart1": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 2, "latitude": 50.45, "longitude": 30.52 },
        "chart2": { "date": "1988-03-20", "time": "09:00:00", "timezoneOffset": -5, "latitude": 40.71, "longitude": -74.0 } }'
```

Повертає:
- `score` (0-100) + `label` (`challenging` / `mixed` / `balanced` / `harmonious`) + `harmony` / `tension`
- `attraction` — окремий скор (Venus-Mars / Moon-Venus / 5-й дім)
- `topAspects` — найвпливовіші міжкартові аспекти з `tone`
- `greenFlags` / `redFlags` — гармонійні особисті аспекти проти напружених до Mars/Saturn/Uranus/Pluto

<Aside type="note">
Прапорці й оцінка — це переформатований вивід **того самого** GREEN synastry-рушія (`calcCompatibilityScore` + `calcAttractionScore`); жодної вигаданої моделі скорингу. Числа ідентичні `/synastry` + `/synastry/attraction-score`.
</Aside>

## Повний набір сумісності

| Потреба | Ендпоінт |
|---|---|
| Повна синастрія (усі крос-аспекти) | `POST /v1/synastry` |
| Сітка аспектів / накладання домів / баланс стихій | `POST /v1/synastry/{aspect-grid,house-overlay,element-balance}` |
| AI-наратив сумісності («чому ви підходите») | `POST /v1/interpret/synastry` |
| Ведична сумісність (Ashtakoot 36 балів, для India) | `POST /v1/vedic/compatibility/{ashtakoot,full,manglik-check}` |
| Довгострокова перспектива (середня карта) | `POST /v1/composite`, `POST /v1/davison` |

## Ціна

`/match/score` — **Tier 3**. Решта ендпоінтів сумісності — за [тарифами кредитів](/rate-limits-credits/). Доставка не тарифікується окремо.