/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_natal | string | обязательный | |
| chart_name_transit | string | обязательный | |
| date_time_natal | string (date-time) | обязательный | |
| date_time_transit | string (date-time) | обязательный | |
| latitude_natal | number (double) | обязательный | min -180 · max 180 |
| latitude_transit | number (double) | обязательный | min -180 · max 180 |
| longitude_natal | number (double) | обязательный | min -180 · max 180 |
| longitude_transit | number (double) | обязательный | min -180 · max 180 |
| mode | integer | обязательный | |
| ref_celestial | string | обязательный | 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. Подробнее — в справочнике ошибок.