API — Натальная карта
Создание натальной карты и получение западного (Western) чарта с планетами, аспектами, домами и дигнитетами.
Создать натальную карту
POST
/api/v1/charts/natal
Тело запроса
| Поле | Тип | Описание |
|---|---|---|
local_birth_datetime | string | Дата и время рождения по местному времени, ISO 8601. Пример: 1990-06-15T14:30:00 |
location.latitude | number | Широта места рождения (десятичные градусы) |
location.longitude | number | Долгота места рождения (десятичные градусы) |
location.place_name | string | Название места (произвольная строка, для отображения) |
house_system | string | Система домов: whole_sign, placidus, koch и др. |
Пример запроса
curl https://api.cosmicmodules.com/api/v1/charts/natal \
-X POST \
-H "X-API-Key: ваш_ключ" \
-H "Content-Type: application/json" \
-d '{"local_birth_datetime":"1990-06-15T14:30:00","location":{"latitude":55.7558,"longitude":37.6173,"place_name":"Москва, Россия"},"house_system":"whole_sign"}'Ответ
{"chart_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}Сохраните chart_id — он используется во всех последующих запросах по этой карте.
Получить Western-карту
GET
/api/v1/charts/{chart_id}
Пример запроса
curl https://api.cosmicmodules.com/api/v1/charts/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
-H "X-API-Key: ваш_ключ"Поля ответа
| Поле | Тип | Описание |
|---|---|---|
chart_id | string | UUID карты |
house_system | string | Использованная система домов |
planets | array | Положения планет (см. ниже) |
aspects | array | Аспекты между планетами |
dignities | array | Дигнитеты планет |
angles | array | Углы карты (AC, MC, DC, IC) |
element_distribution | object | Распределение по стихиям |
modality_distribution | object | Распределение по модальностям |
Объект планеты (planets[])
| Поле | Тип | Описание |
|---|---|---|
body_id | string | Идентификатор: sun, moon, mercury и т.д. |
sign | string | Знак зодиака: aries, taurus и т.д. |
degree | string | Градус в знаке (десятичный) |
is_retrograde | boolean | Ретроградность |
house_number | number|null | Номер дома (1–12) |
Объект аспекта (aspects[])
| Поле | Тип | Описание |
|---|---|---|
body_a | string | Первая планета |
body_b | string | Вторая планета |
aspect_type | string | Тип: conjunction, opposition, trine и др. |
orb | string | Орб в градусах |
applying | boolean|null | Применяющийся (true) или разделяющийся (false) |