Синастрія

Ендпоінт POST /v1/synastry порівнює дві натальні карти: обчислює крос-аспекти між планетами обох людей і повертає бал сумісності. Вартість: 50 кредитів (Tier 3).

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

Два вкладених об’єкти chart1 і chart2, кожен з тими ж параметрами, що й /v1/chart:

Параметр	Тип	Обов’язковий	Опис
chart1	object	Так	Дані першої людини
chart2	object	Так	Дані другої людини

Кожен об’єкт: date, time, timezoneOffset, latitude, longitude, houseSystem, name, city.

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

cURL

curl -X POST https://api.astroway.info/v1/synastry \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "chart1": {
      "date": "1990-07-14",
      "time": "14:30:00",
      "timezoneOffset": 3,
      "latitude": 50.4501,
      "longitude": 30.5234,
      "name": "Person A"
    },
    "chart2": {
      "date": "1992-03-22",
      "time": "09:15:00",
      "timezoneOffset": 2,
      "latitude": 48.8566,
      "longitude": 2.3522,
      "name": "Person B"
    }
  }'

Node.js

const body = {
  chart1: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, name: 'Person A' },
  chart2: { date: '1992-03-22', time: '09:15:00', timezoneOffset: 2, latitude: 48.8566, longitude: 2.3522, name: 'Person B' },
};
const res = await fetch('https://api.astroway.info/v1/synastry', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
  },
  body: JSON.stringify(body),
});
const result = await res.json();
console.log(result.compatibility);
console.log(result.crossAspects.length);

Python

import os, requests

body = {
    'chart1': {'date': '1990-07-14', 'time': '14:30:00', 'timezoneOffset': 3, 'latitude': 50.4501, 'longitude': 30.5234, 'name': 'Person A'},
    'chart2': {'date': '1992-03-22', 'time': '09:15:00', 'timezoneOffset': 2, 'latitude': 48.8566, 'longitude': 2.3522, 'name': 'Person B'},
}
r = requests.post(
    'https://api.astroway.info/v1/synastry',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json=body,
)
result = r.json()
print(result['compatibility'])

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('synastry', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'chart1' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'timezoneOffset' => 3,
            'latitude' => 50.4501,
            'longitude' => 30.5234,
            'name' => 'Person A',
        ],
        'chart2' => [
            'date' => '1992-03-22',
            'time' => '09:15:00',
            'timezoneOffset' => 2,
            'latitude' => 48.8566,
            'longitude' => 2.3522,
            'name' => 'Person B',
        ],
    ],
]);

$result = json_decode($r->getBody(), true);
print_r($result['compatibility']);

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

{
  "chart1": {
    "input": { "date": "1990-07-14", "name": "Person A" },
    "planets": [ ... ],
    "houses": { ... },
    "aspects": [ ... ]
  },
  "chart2": {
    "input": { "date": "1992-03-22", "name": "Person B" },
    "planets": [ ... ],
    "houses": { ... },
    "aspects": [ ... ]
  },
  "crossAspects": [
    {
      "planet1": "Sun",
      "planet2": "Venus",
      "chart1Planet": "Sun",
      "chart2Planet": "Venus",
      "type": "trine",
      "orb": 2.14,
      "applying": false
    },
    {
      "planet1": "Moon",
      "planet2": "Mars",
      "chart1Planet": "Moon",
      "chart2Planet": "Mars",
      "type": "square",
      "orb": 0.87,
      "applying": true
    }
  ],
  "compatibility": {
    "score": 72,
    "label": "harmonious",
    "harmony": 18.5,
    "tension": 7.2
  }
}

Poznámka

chart1 і chart2 — повні натальні карти (ті ж поля, що й у /v1/chart). crossAspects — аспекти між планетами двох карт. compatibility.score — від 0 до 100.

Поле compatibility

Поле	Тип	Опис
score	number	Загальний бал 0–100
label	string	harmonious, balanced, mixed, challenging
harmony	number	Зважена сума гармонійних аспектів (trine, sextile)
tension	number	Зважена сума напружених аспектів (square, opposition)

Пов’язані ендпоінти

Ендпоінт	Кредити	Що додає
/v1/composite	50	Композитна карта (середні точки)
/v1/davison	50	Карта Давісона (середня дата)
/v1/coalescent	50	Коалесцентна карта
/v1/group-synastry	100	Матриця сумісності 2–10 людей
/v1/human-design/compatibility	100	HD-сумісність

Далі

• Натальна карта — базовий запит
• Транзити — транзитний оверлей
• Human Design — повна HD-карта
• API reference — усі 705 ендпоінтів