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

Повний довідник цього ендпоінта