Перейти до вмісту
Occult API
POST/api/planetary_details/1 кредит

Відомості про планети

Один виклик виконує дев’ять окремих сканувань ефемерид за діапазон дат і повертає всі результати разом. Звертайтеся до цього ендпоінта, коли потрібно все, що відбувається з планетами між двома датами, а не знімок на один момент: зміни знаків і накшатр, ретроградні періоди, збіги схилень і виходи за межі (out-of-bounds). `start_date` і `end_date` задають вікно, `planet_name` і `sign` звужують три розділи, що стосуються конкретної планети, а `longitude` — екліптичний градус для пошуку положення. Якщо передати `geo_latitude` і `geo_longitude`, з’явиться ще один розділ — інгресії асцендента; без них його немає. Зверніть увагу: вікно сканується повністю, тож діапазон у кілька років обробляється значно довше, ніж кілька днів. Відповідь містить такі ключі (у їхніх назвах є пробіли): `sign transitions`, `planet at position` (коли названа планета стоїть на заданій довготі в заданому знаку), `planet ingress exit` (час входу й виходу названої планети лише для названого знака), `planet nakshatra ingress exit` (ключі — усі двадцять сім накшатр, значення — списки вікон `{start_date, end_date}`), `planet sankranti times` (ключі — усі підтримувані тіла, зокрема уранічні точки й супутники планет), `planet retrogression dates` (ключі — планети, значення — списки `{start, end}`), `planet krantisamya dates` (список `{Planet_1, Planet_2, DateTime, Alignment}`, де Alignment — North-North, South-South або Opposite, тобто однакове чи дзеркальне схилення), `abhijit nakshatra periods` і `planet oob range` (періоди, коли тіло виходить за межі максимального схилення Сонця). Порожній список означає, що у вашому вікні нічого такого не сталося.

https://api.occultapi.com/api/planetary_details/
Спробувати запит

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

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

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

Поля запиту

ПолеТипОбов’язковеПримітки
end_datestring (date-time)обов’язковий
longitudenumber (double)обов’язковий

Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї.

min -180 · max 180

planet_namestringобов’язковий
sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutotruenodemeannode

Одне з: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, truenode, meannode. У нижньому регістрі. Інші назви тіл проходять перевірку, але даних для них немає, тож запит завершиться помилкою.

signstringобов’язковий
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

З УРАХУВАННЯМ РЕГІСТРУ — англійські назви знаків із великої літери (Title Case), точно в такому написанні; 'aries' не спрацює. Також використовується для фільтрації результату входу/виходу до запитаного знака.

start_datestring (date-time)обов’язковий
geo_latitudenumber (double)необов’язковий

Географічна широта спостерігача (від -90 до 90). Обов’язкова для даних про вхід асцендента.

min -90 · max 90

geo_longitudenumber (double)необов’язковий

Географічна довгота спостерігача (від -180 до 180). Обов’язкова для даних про вхід асцендента.

min -180 · max 180

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

curl -X POST https://api.occultapi.com/api/planetary_details/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_date":"2024-11-21T08:33:35.539Z","end_date":"2024-11-22T08:33:35.539Z","longitude":76.125,"planet_name":"mercury","sign":"Taurus"}'

Відповідь

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"sign transitions\": {}, \"planet at position\": {\"mercury\": {\"positions\": []}}, \"planet ingress exit\": {\"mercury\": {}}, \"planet nakshatra ingress exit\": {\"mercury\": {\"Ashwini\": [], \"Bharani\": [], \"Krittika\": [], \"Rohini\": [], \"Mrigasira\": [], \"Aardra\": [], \"Punarvasu\": [], \"Pushyami\": [], \"Aasresha\": [], \"Makha\": [], \"Poorva Phalguni\": [], \"Uttara Phalguni\": [], \"Hasta\": [], \"Chitra\": [], \"Swaati\": [], \"Visaakha\": [], \"Anooraadha\": [], \"Jyeshtha\": [{\"start_date\": \"2024-11-21 08:33:35\", \"end_date\": \"2024-11-22 08:33:35\"}], \"Moola\": [], \"Poorvaashaadha\": [], \"Uttaraashaadha\": [], \"Sravanam\": [], \"Dhanishtha\": [], \"Satabhishak\": [], \"Poorvaabhaadra\": [], \"Uttaraabhaadra\": [], \"Revati\": []}}, \"planet sankranti times\": {\"sun\": [], \"moon\": [], \"mercury\": [], \"venus\": [], \"mars\": [], \"jupiter\": [], \"saturn\": [], \"uranus\": [], \"neptune\": [], \"pluto\": [], \"truenode\": [], \"meannode\": [], \"chiron\": [], \"pholus\": [], \"ceres\": [], \"pallas\": [], \"juno\": [], \"vesta\": [], \"cupido\": [], \"hades\": [], \"zeus\": [], \"kronos\": [], \"apollon\": [], \"admetos\": [], \"vulkanus\": [], \"poseidon\": [], \"selena\": [], \"phobos\": [], \"deimos\": [], \"io\": [], \"europa\": [], \"ganymede\": [], \"callisto\": [], \"titan\": [], \"triton\": [], \"charon\": []}, \"planet retrogression dates\": {\"jupiter\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"mars\": [], \"meannode\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"mercury\": [], \"moon\": [], \"neptune\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"pluto\": [], \"saturn\": [], \"sun\": [], \"truenode\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"uranus\": [{\"start\": \"2024-11-21 08:33:35\", \"end\": \"2024-11-22 08:33:35\"}], \"venus\": []}, \"planet krantisamya dates\": [{\"Planet_1\": \"sun\", \"Planet_2\": \"truenode\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"meannode\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"zeus\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"Opposite\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"kronos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"apollon\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"Opposite\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"admetos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"vulkanus\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"poseidon\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"Opposite\"}, {\"Planet_1\": \"sun\", \"Planet_2\": \"selena\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"mercury\", \"Planet_2\": \"venus\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"mars\", \"Planet_2\": \"phobos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"mars\", \"Planet_2\": \"deimos\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"io\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"europa\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"ganymede\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"jupiter\", \"Planet_2\": \"callisto\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"saturn\", \"Planet_2\": \"titan\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"neptune\", \"Planet_2\": \"triton\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"pluto\", \"Planet_2\": \"charon\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"South-South\"}, {\"Planet_1\": \"truenode\", \"Planet_2\": \"meannode\", \"DateTime\": \"2024-11-21 08:33:35\", \"Alignment\": \"North-North\"}, {\"Planet_1\": \"truenode\", \"Planet_2\": \"zeus\", \"DateTime\": \"2024-11-21 08:33"
}

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

Помилки

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