/api/astro/lunar_month_scan/1 кредитСканирование лунного месяца
Находит точные моменты начала и конца одного индуистского лунного месяца с заданным названием в пределах календарного года — Chaitra, Vaisakha, Jyeshtha и так далее. Пригодится для любых расписаний, привязанных к лунному, а не к григорианскому месяцу. Параметр reckoning определяет, где проходят границы месяцев. В системе 'amanta' (по умолчанию, принята на юге и западе) месяц длится от одного новолуния до следующего и называется по знаку Луны в новолуние, с которого он начинается. В системе 'poornima' месяц длится от одного полнолуния до следующего и называется по знаку Солнца в начальное полнолуние; так считают северные календари. В тёмную половину месяца две системы относят один и тот же день к месяцам с разными названиями. Передайте month_name, year и timezone_as_float; место не нужно. Ответ — {year, month_name, reckoning, rows}, где rows — список меток {start, end} в UTC. Обычно запись одна, а если в этом году есть ещё и адхика (вставной месяц) с тем же названием — две. Какой из двух месяцев вставной, сканирование не помечает.
https://api.occultapi.com/api/astro/lunar_month_scan/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| month_name | string | обязательный | VaisakhaJyeshthaAshadhaShravanaBhadrapadaAshwinKartikaMargashirshaPaushaMaghaPhalgunaChaitra |
| timezone_as_float | number (double) | обязательный | Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение. |
| year | integer | обязательный | Год рождения числом, например 1990. Четыре цифры. min 1800 · max 2400 |
| reckoning | string | необязательный | amantapoornima |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/lunar_month_scan/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"month_name":"Vaisakha","timezone_as_float":5.5,"year":2026,"reckoning":"amanta"}'Ответ
{
"data": {
"year": 2026,
"month_name": "Vaisakha",
"reckoning": "amanta",
"rows": [
{
"start": "2026-04-17T11:52:21+00:00",
"end": "2026-05-16T20:01:32+00:00"
}
]
},
"message": "successful",
"is_error": false
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.