Перейти до вмісту
Occult API
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. Детальніше — у довіднику помилок.