/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. Подробнее — в справочнике ошибок.