/api/astro/combustion/1 кредитПеріоди спалення
Коли планета так близько до Сонця, що її не видно, кажуть, що вона спалена — аста, «зайшла», — і класичні тексти вважають, що вона згоріла й не може дати своїх результатів. Цей ендпоінт повертає для однієї планети всі періоди спалення, що зачіпають заданий календарний рік. Перевірка суто кутова. Планета спалена, поки її геоцентрична елонгація від Сонця менша за орбіс, свій для кожної планети: 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` впливає лише на те, у якому часовому поясі їх показано.
https://api.occultapi.com/api/astro/combustion/
Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| 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 |
Приклад запиту
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}'Відповідь
{
"data": {
"planet": "mars",
"year": 2026,
"periods": [
{
"start": "2025-11-06T23:51:13.853078",
"end": "2026-03-26T14:07:06.209182",
"duration_days": 139.6,
"days_in_year": 84.6
}
],
"total_asta_days_in_year": 84.6
},
"message": "successful",
"is_error": false
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.