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}`: булеве значення, чи діє фаза в момент транзиту, і дата закінчення в UTC у форматі ISO 8601, якщо діє, або 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. Детальніше — у довіднику помилок.