API синастрії

Запит

Справжній запит для двох вигаданих людей: одна має демонстраційні дані народження в Києві, друга народилася в Нью-Йорку.

curl -X POST https://api.natalchart.ai/v1/synastry \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personA":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"personB":{"date":"1989-03-14","time":"07:45","latitude":40.7128,"longitude":-74.006}}'

Відповідь

Частина відповіді на цей запит: основні поля, кожен список скорочено до перших трьох елементів.

{
  "aspects": [
    {
      "personA": "Neptune",
      "personB": "Lilith",
      "aspect": "Trine",
      "angle": 120.08,
      "orb": 0.08
    },
    {
      "personA": "Saturn",
      "personB": "Jupiter",
      "aspect": "Trine",
      "angle": 119.66,
      "orb": 0.34
    },
    {
      "personA": "Mercury",
      "personB": "Moon",
      "aspect": "Sextile",
      "angle": 60.38,
      "orb": 0.38
    }
  ],
  "sphereScores": {
    "identity": 89,
    "love": 81,
    "body": 86,
    "money": 76,
    "home": 83,
    "mind": 66
  }
}

Що повертається

• aspects: кожен мажорний аспект між тілом однієї карти й тілом іншої, з кутом і орбісом.
• overlays: у які доми карти іншої людини потрапляють планети кожного, в обидва боки. Одна зі сторін дорівнює null, якщо час народження іншої людини невідомий, бо доми залежать від нього.
• sphereScores: оцінки сфер Я, Любов, Тіло, Гроші, Дім і Розум, кожна від 0 до 100, складені з аспектів між картами (60%) і накладання домів (40%).
• scoring: правило, за яким обчислено оцінки, наведене прямо у відповіді. Воно описує геометрію двох карт, а не майбутнє стосунків.

Обмеження

• Лише API Pro. З безкоштовним ключем ендпоінт відповідає кодом 403 і посиланням для переходу на API Pro.
• Дати народження з 1800 по 2399 рік. Тропічний зодіак, доми за Плацидусом, п'ять мажорних аспектів.
• Без геокодування: надсилайте координати. Часовий пояс визначається за ними з правилами переходу на літній час, чинними на дату народження.
• Дані народження зчитуються, використовуються й забуваються: тіла запитів ніколи не зберігаються.

В AI-асистенті

MCP-сервер за адресою https://www.natalchart.ai/mcp пропонує те саме обчислення як інструмент synastry, тож Claude, ChatGPT чи Cursor можуть порівняти дві карти, перш ніж говорити про сумісність.

Інші можливості API

Той самий ключ відкриває весь астрологічний API: натальні карти, щоденні транзити, синастрію, транзити за період, соляри, найкращі дні й астрокартографію. Усі ендпоінти, поля й помилки описано в документації, а на сторінці цін пояснено, що вважається запитом.

Запитання