API соляра

Запит

Справжній запит: соляр демонстраційної карти на 2027 рік у місці народження.

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"year":2027}'

Відповідь

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

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

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

• exactMomentUtc: момент, коли Сонце знову доходить до своєї натальної довготи, за UTC.
• location: місце, для якого будується карта; місце народження, якщо ви не надішлете інше.
• natalSun: довгота натального Сонця, від якої відраховується соляр.
• chart: повна карта на цей момент і для цього місця в тій самій структурі, що й відповідь ендпоінта натальної карти.

Обмеження

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

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

Через MCP-сервер за адресою https://www.natalchart.ai/mcp асистенти викликають інструмент solar_return і читають рік уперед за обчисленою картою.

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

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

Запитання