Перейти к основному содержимому
POST/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_namestringобязательный
VaisakhaJyeshthaAshadhaShravanaBhadrapadaAshwinKartikaMargashirshaPaushaMaghaPhalgunaChaitra
timezone_as_floatnumber (double)обязательный

Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение.

yearintegerобязательный

Год рождения числом, например 1990. Четыре цифры.

min 1800 · max 2400

reckoningstringнеобязательный
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. Подробнее — в справочнике ошибок.