Перейти к основному содержимому
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

С УЧЁТОМ РЕГИСТРА — английские названия знаков с заглавной буквы, в точности как написано; '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. Подробнее — в справочнике ошибок.