POST/api/astro/astrocartography/local-space/1 кредит

Лінії локального простору

Азимут (напрямок за компасом) від місця народження на кожну планету, продовжений через усю мапу. Це інша техніка релокації, ніж лінії ACG. Тут питають не про те, де на Землі планета була на куті, а про те, у якому напрямку вона була на небі, якщо дивитися З місця народження; цей напрямок продовжують як великий круг. Вважається, що подорож уздовж лінії планети приносить у життя теми цієї планети. Азимут відлічується від істинної півночі й зростає на схід, тож його можна читати просто як напрямок за компасом; для відображення додано назву румба 16-румбового компаса. Для кожного тіла також є готовий до малювання список точок уздовж його великого круга з фіксованим кутовим кроком. Висоту ми повертаємо, а не використовуємо як фільтр. Планета під горизонтом теж має азимут, а чи малювати її лінію, астрологи-практики вирішують по-різному, тож ми даємо число і прапорець above_horizon, а вибір залишаємо вам. На відміну від трьох інших ендпоінтів цього розділу, цей справді залежить від місця народження, тому latitude і longitude обов’язкові.

https://api.occultapi.com/api/astro/astrocartography/local-space/

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

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

Передавайте ключ у заголовку 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' — різні моменти, і відповіді для них різні.
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
bodies	array	необов’язковий
keys	array	необов’язковий	Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами.
node	string	необов’язковий	Який місячний вузол означає `north_node`: true (за замовчуванням) або mean. `truemean`

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

Цей приклад ще не перевірено

Назви й типи полів нижче взято з опису API, тож вони точні. Але саме це тіло запиту під час останнього запуску не повернуло успішної відповіді: можливо, йому бракує значення, яке ми не можемо вгадати. Вважайте його заготовкою, а не готовою командою.

curl -X POST https://api.occultapi.com/api/astro/astrocartography/local-space/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-01 06:00:00","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"node":"true"}'

Відповідь

Перевіреного прикладу відповіді для цього ендпоінта поки немає. Структуру запиту вище згенеровано з опису API, і вона точна. Приклади відповідей ми публікуємо лише тоді, коли перевіримо їх на реальному виклику.

Помилки

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