POST/api/astro/transit/moon-crossing/1 кредит

Перетин Місяця

Коли Місяць наступного разу досягне заданої екліптичної довготи. Місяць проходить увесь зодіак приблизно за 27 днів, тож перетин ніколи не буває далі ніж за місяць. Лише пошук уперед — з тієї самої причини, що й для сонячної інгресії.

https://api.occultapi.com/api/astro/transit/moon-crossing/

Спробувати запит

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запиту

Поле	Тип	Обов’язкове	Примітки
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' — різні моменти, і відповіді для них різні.
celestial	string	необов’язковий	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
celestial1	string	необов’язковий	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
celestial2	string	необов’язковий	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
datetime_end	string (date-time)	необов’язковий
datetime_start	string (date-time)	необов’язковий
degr	number (double)	необов’язковий	min 0 · max 360
keys	array	необов’язковий	Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами.
latitude	number (double)	необов’язковий	Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -90 · max 90
longitude	number (double)	необов’язковий	Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180
planet	string	необов’язковий	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
timezone_as_float	number (double)	необов’язковий	Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. min -12 · max 14
tz	number (double)	необов’язковий	Зміщення від UTC, у якому подано повернуті часи. min -12 · max 14
when	string	необов’язковий	Лише вперед; див. docstring модуля щодо `before`. `after`
x2cross	number (double)	необов’язковий	Екліптична довгота, перетин якої треба знайти: 0-360 від 0° Овна. min 0 · max 360

Приклад запиту

curl -X POST https://api.occultapi.com/api/astro/transit/moon-crossing/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2025-01-01T00:00:00+00:00","tz":0,"when":"after","x2cross":90}'

Відповідь

{
  "data": {
    "body": "moon",
    "target_longitude": 90,
    "direction": "after",
    "crossing": "2025-01-12T04:24:03Z"
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.