API — Вимшоттари-даша

Вимшоттари-даша — основная планетарная система периодов в ведической астрологии. После создания натальной карты (POST /charts/natal) API автоматически вычисляет Вимшоттари-карту.

Список Вимшоттари-карт

GET /api/v1/charts/vimshottari

Параметры запроса

ПараметрТипОписание
limitintegerМаксимальное число результатов

Пример запроса

curl "https://api.cosmicmodules.com/api/v1/charts/vimshottari?limit=10" \
  -H "X-API-Key: ваш_ключ"

Пример ответа

{"charts": [{"chart_id": "3fa85f64-..."}, ...], "total": 1}

Интерпретации периодов

GET /api/v1/charts/vimshottari/{vimshottari_id}/interpretations

Пример запроса

curl https://api.cosmicmodules.com/api/v1/charts/vimshottari/3fa85f64-.../interpretations \
  -H "X-API-Key: ваш_ключ"

Поля ответа

ПолеТипОписание
chart_idstringUUID карты
periodsarrayМассив периодов

Объект периода (periods[])

ПолеТипОписание
lordstringПланета-управитель периода
duration_yearsnumberДлительность в годах
start_datestringДата начала (ISO 8601)
end_datestringДата окончания
is_activebooleanТекущий период?
textstring|nullИнтерпретация периода
sub_lordstring|nullУправитель антардаши
sub_start_datestring|nullНачало антардаши
sub_end_datestring|nullОкончание антардаши
sub_textstring|nullИнтерпретация антардаши

Накшатра-синтез

GET /api/v1/charts/{chart_id}/nakshatra-synthesis

Параметры запроса

ПараметрТипОписание
datetimestringТекущий момент в UTC (ISO 8601, URL-encoded). Влияет на активные антардаши.

Пример запроса

curl "https://api.cosmicmodules.com/api/v1/charts/3fa85f64-.../nakshatra-synthesis?datetime=2026-07-17T12%3A00%3A00" \
  -H "X-API-Key: ваш_ключ"

Поля ответа (planets[])

ПолеТипОписание
planetstringНазвание планеты
nakshatrastring|nullНакшатра
padanumber|nullПада (1–4)
nakshatra_lordstring|nullУправитель накшатры
narrativestring|nullТекстовая интерпретация