POSThttps://api.occultapi.com/api/astro/combustion/

Периоды сожжения

Тело запросаJSON

Чтобы отправить запрос, вставьте API-ключ выше.

Фрагмент кода

curl -X POST https://api.occultapi.com/api/astro/combustion/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"planet":"mars","year":2026,"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Когда планета подходит к Солнцу так близко, что её не видно, её называют сожжённой — аста, «зашедшая». Классические тексты считают такую планету сгоревшей и неспособной дать свои результаты. Этот эндпоинт возвращает для одной планеты все периоды сожжения, которые затрагивают заданный календарный год. Проверка чисто угловая. Планета сожжена, пока её геоцентрическая элонгация от Солнца меньше орбиса для этой планеты: 17° для Марса, 14° для директного Меркурия и 12° для ретроградного, 10° для директной Венеры и 8° для ретроградной, 11° для Юпитера и 15° для Сатурна. Год сканируется с запасом на обоих концах, потому что период может переходить через Новый год, а каждое пересечение затем уточняется методом бисекции. Передайте `planet` (mars, mercury, venus, jupiter или saturn) и `year`. Ответ — `{planet, year, periods, total_asta_days_in_year}`; для каждого периода указаны `start`, `end`, `duration_days` для всего периода и `days_in_year` для его части, которая приходится на запрошенный год. Элонгация не зависит от места наблюдения, поэтому время периодов от места не зависит; `timezone_as_float` влияет только на то, как оно выводится.

Поля запроса

Поле	Тип	Обязательно	Примечания
planet	string	обязательный	`marsmercuryvenusjupitersaturn`
year	integer	обязательный	Год рождения числом, например 1990. Четыре цифры. min 1800 · max 2400
latitude	number (double)	необязательный	Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы.
longitude	number (double)	необязательный	Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае.
timezone_as_float	number (double)	необязательный	Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение. min -12 · max 14

Полный справочник по этому эндпоинту