Перейти к основному содержимому
POST/api/astro/shani_analysis/1 кредит

Фазы транзита Сатурна

За время медленного обхода зодиака Сатурн проходит четыре фазы со своими названиями, за которыми внимательно следит индийская астрология. Все они отсчитываются от натальной Луны или натального асцендента: саде-сати — семь с половиной лет вокруг прохождения Сатурна через эту точку; аштама-шани — Сатурн в восьмом доме от неё; кантака-шани — Сатурн в четвёртом, седьмом или десятом доме; дхайя, она же ардхаштама, — Сатурн в четвёртом или восьмом. Эндпоинт сообщает, действует ли каждая фаза в заданный момент, когда она закончится и когда начнётся следующая. Передайте две карты: данные рождения в полях `date_time_natal`, `latitude_natal`, `longitude_natal` и `chart_name_natal` и интересующий вас момент в соответствующих полях `_transit`. `ref_celestial` определяет, от чего отсчитываются фазы: от натальной Луны или от натального асцендента. `mode` задаёт строгость проверки: при 0 проверяется положение по домам целых знаков, а при больших значениях — окно в градусах вокруг опорной точки, что даёт заметно более узкие даты начала и конца. Ответ содержит восемь объектов. `ashtama_shani`, `kantaka_shani`, `dhaiya_shani` и `sade_sati_shani` имеют вид `{status, end_date}`: булево значение (действует ли фаза в момент транзита) и дата окончания в формате ISO 8601 UTC, если фаза действует, или null, если нет. `next_ashtama_shani`, `next_kantaka_shani` и `next_dhaiya_shani` имеют вид `{date, ref_house_from_natal}`: дата начала следующего наступления и дом от опорной точки, который его вызывает; `next_sade_sati_shani` даёт только `{date}`. Поиск вперёд охватывает сто лет от момента транзита. Кантака и дхайя обе включают четвёртый дом, поэтому часто показывают одни и те же даты. Так и должно быть, это не дублирование.

https://api.occultapi.com/api/astro/shani_analysis/
Попробовать запрос

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запроса

ПолеТипОбязательноПримечания
chart_name_natalstringобязательный
chart_name_transitstringобязательный
date_time_natalstring (date-time)обязательный
date_time_transitstring (date-time)обязательный
latitude_natalnumber (double)обязательный

min -180 · max 180

latitude_transitnumber (double)обязательный

min -180 · max 180

longitude_natalnumber (double)обязательный

min -180 · max 180

longitude_transitnumber (double)обязательный

min -180 · max 180

modeintegerобязательный
ref_celestialstringобязательный
ascendantmoon

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

curl -X POST https://api.occultapi.com/api/astro/shani_analysis/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time_natal":"2025-11-21T05:41:58.124Z","date_time_transit":"2024-11-21T05:41:58.124Z","longitude_natal":77.5946,"latitude_natal":12.9716,"longitude_transit":26.1046,"latitude_transit":26.9124,"chart_name_natal":"RashiChart","chart_name_transit":"RashiChart","ref_celestial":"ascendant","mode":0}'

Ответ

{
  "data": {
    "ashtama_shani": {
      "status": false,
      "end_date": null
    },
    "kantaka_shani": {
      "status": false,
      "end_date": null
    },
    "dhaiya_shani": {
      "status": false,
      "end_date": null
    },
    "sade_sati_shani": {
      "status": true,
      "end_date": "2025-03-09T10:21:25Z"
    },
    "next_ashtama_shani": {
      "date": "2036-08-08T03:38:39Z",
      "ref_house_from_natal": 8
    },
    "next_kantaka_shani": {
      "date": "2027-05-11T00:01:56Z",
      "ref_house_from_natal": 4
    },
    "next_dhaiya_shani": {
      "date": "2027-05-11T00:01:56Z",
      "ref_house_from_natal": 4
    },
    "next_sade_sati_shani": {
      "date": "2046-02-22T02:59:10Z"
    }
  },
  "message": "successful",
  "is_error": false
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data.

Ошибки

Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.