# API аспектів за схиленням

Більшість роботи з аспектами відбувається вздовж екліптики, у довготі, але два тіла можуть співвідноситися й за схиленням — відстанню на північ чи південь від небесного екватора. Цей ендпоінт працює у цьому другому вимірі, знаходячи паралелі й контрпаралелі, схиленнєві аналоги з'єднання та опозиції, і відзначаючи, коли тіло виходить за межі.

## Ендпоінт

`POST /v1/parallel-aspects`

- Operation ID: `parallel-aspects`
- Вартість: 20 кредитів (тариф 2)
- Типова латентність: 64 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/declinations/

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

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

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

Звертайтеся до цього ендпоінта, коли рушій аспектів не має зупинятися на екліптиці — для серйозного аналізатора карти, інструмента синастрії чи транзитів, що хоче схиленнєвий шар, або звіту, що пояснює, чому дві планети відчуваються пов'язаними попри відсутність довготного аспекту. Паралелі й контрпаралелі — саме ті контакти, що їх відкидає сітка лише за довготою, тож додавання їх заповнює реальну прогалину, а не дублює аспектний вивід natal-chart. Позначка виходу за межі корисна окремо: вона маркує планети, що їх традиція вважає такими, що діють без стриму, і це робить охайне виділення у звіті по карті. Надішліть ті самі дані народження, що й деінде, і схиленнєві контакти посилатимуться на ті самі тіла, що й ваші довготні аспекти, дозволяючи подати обидві сітки як два прочитання однієї карти.

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `date` | string (YYYY-MM-DD) | yes | Birth date. |
| `time` | string (HH:MM:SS) | yes | Local clock time at birth. |
| `timezoneOffset` | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| `latitude` | number | yes | Birth-place latitude, decimal degrees (north positive). |
| `longitude` | number | yes | Birth-place longitude, decimal degrees (east positive). |

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

```bash
curl -X POST https://api.astroway.info/v1/parallel-aspects \
  -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
}'
```

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

```json
{
  "ok": true,
  "data": {
    "parallels": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "contra-parallel",
        "orb": 0.49
      }
    ]
  }
}
```

## Нотатки

Паралелі й контрпаралелі слідують традиційній доктрині схилення, трактуючи контакти рівного схилення як аналоги з'єднання та опозиції; читання виходу за межі спирається на роботу Кт Бере. Схилення обчислюються рушієм Swiss Ephemeris (Astrodienst) на WASM у тропічній системі, на тих самих тілах, що й довготні натальні ендпоінти.

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

- https://api.astroway.info/astrology-api/midpoint-tree/
- https://api.astroway.info/astrology-api/natal-chart/

---

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