Завантаження Playground
curl -X POST https://api.occultapi.com/api/astro/moonrise/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873}'Схід і захід Місяця для дати й місця, а також час, який Місяць проводить над горизонтом, у секундах. Для Сонця використовуйте /api/astro/sunrise/. Надішліть дату, широту, довготу й зміщення від UTC. Як і зі сходом Сонця, ті самі моменти можна отримати через /api/astro/celestial/, але лише якщо знати, що треба передати planet_names=["MOON"], поставити перемикач сходу першим у масиві keys і розгорнути вкладений масив. Захід Місяця у відповіді — завжди той, що НАСТАЄ ПІСЛЯ сходу, тож пара утворює придатний інтервал. Для Місяця це важливіше, ніж для Сонця: він сходить щодня приблизно на п’ятдесят хвилин пізніше, тож у багатьох датах захід Місяця, що припадає на ваш календарний день, належить до попереднього сходу. Обидва поля можуть бути null. Вище приблизно 61 градуса широти Місяць може понад добу залишатися над горизонтом або під ним — так буває в Рейк’явіку в грудні, — і тоді сходу чи заходу просто немає. Саме про це й каже null; /api/astro/celestial/ натомість повертає "2000-11-24T12:00:00Z" — нульовий юліанський день, результат невдалого пошуку, а не реальний момент, і його легко сплутати з відповіддю. Фазу Місяця й пакшу повертає /api/astro/panchang/.
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| date_time | string (date-time) | обов’язковий | Момент, для якого виконується розрахунок, у форматі ISO 8601. ЗАВЖДИ вказуйте зміщення або Z у кінці: значення без часового поясу читається як Asia/Kolkata (UTC+05:30), а не UTC, і може повернути результат за попередній день із кодом 200. '2026-09-01T06:00:00Z' і '2026-09-01 06:00:00' — різні моменти, і відповіді для них різні. |
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -89.9 · max 89.9 |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180 |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. min -12 · max 14 |
| keys | array | необов’язковий | Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами. |