Перейти к основному содержимому
Occult API
POST/api/astro/fixed-star/parans/1 кредит

Параны звёзд и планет

Широты, на которых неподвижная звезда и планета одновременно находятся на углах карты. По паранам толкует неподвижные звёзды школа Бернадетт Брейди, и они улавливают контакт, который соединение по долготе полностью пропускает: в зодиаке звезда может быть далеко от планеты и всё же восходить в тот самый момент, когда планета кульминирует. Поскольку ответ — это ШИРОТА, он действует по всей этой широте вокруг земного шара, а не в одном месте. Рассчитывается по той же геометрии, что и /api/astro/astrocartography/parans/, только место одного из тел занимает звезда. Пары меридианных линий исключены: линии MC и IC — настоящие меридианы и никогда не пересекаются.

https://api.occultapi.com/api/astro/fixed-star/parans/
Попробовать запрос

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

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

Поля запроса

ПолеТипОбязательноПримечания
date_timestring (date-time)обязательный

Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC, и может вернуть результат за предыдущий день со статусом 200. '2026-09-01T06:00:00Z' и '2026-09-01 06:00:00' — разные моменты, и ответы для них будут разными.

bodiesarrayнеобязательный
keysarrayнеобязательный

Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами.

latitudenumber (double)необязательный

Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы.

longitudenumber (double)необязательный

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

max_magnitudenumber (double)необязательный

Только звёзды не тусклее этой величины. Чем меньше число, тем ярче.

presetstringнеобязательный

major (по умолчанию), behenian, brightest или all.

majorbehenianbrightestall
starsarrayнеобязательный

Названия звёзд. Если указаны, имеют приоритет над `preset`.

timezone_as_floatnumber (double)необязательный

Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение.

min -12 · max 14

Пример запроса

curl -X POST https://api.occultapi.com/api/astro/fixed-star/parans/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-05-10T19:55:00+05:30","timezone_as_float":5.5,"stars":["Regulus","Sirius","Aldebaran"],"bodies":["sun","moon","mars"]}'

Ответ

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"julian_day_ut\": 2448022.10069444, \"stars_considered\": 3, \"count\": 30, \"parans\": [{\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"IC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": 64.923938}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"AC\", \"body\": \"sun\", \"body_line\": \"MC\", \"latitude_deg\": 62.975951}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"DC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": 62.127117}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"IC\", \"body\": \"sun\", \"body_line\": \"AC\", \"latitude_deg\": 61.589729}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"IC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": 56.671965}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"DC\", \"body\": \"sun\", \"body_line\": \"DC\", \"latitude_deg\": 55.724692}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"DC\", \"body\": \"mars\", \"body_line\": \"IC\", \"latitude_deg\": 54.239126}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"DC\", \"body\": \"moon\", \"body_line\": \"AC\", \"latitude_deg\": 53.107724}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"AC\", \"body\": \"sun\", \"body_line\": \"MC\", \"latitude_deg\": 50.110307}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"DC\", \"body\": \"moon\", \"body_line\": \"AC\", \"latitude_deg\": 46.105875}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"MC\", \"body\": \"mars\", \"body_line\": \"DC\", \"latitude_deg\": 45.266728}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"MC\", \"body\": \"sun\", \"body_line\": \"DC\", \"latitude_deg\": 38.661486}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"AC\", \"body\": \"moon\", \"body_line\": \"IC\", \"latitude_deg\": 30.223657}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"DC\", \"body\": \"mars\", \"body_line\": \"IC\", \"latitude_deg\": 24.393792}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"MC\", \"body\": \"moon\", \"body_line\": \"AC\", \"latitude_deg\": 15.27243}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"IC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": -15.27243}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"AC\", \"body\": \"mars\", \"body_line\": \"MC\", \"latitude_deg\": -24.393792}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"DC\", \"body\": \"moon\", \"body_line\": \"MC\", \"latitude_deg\": -30.223657}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"IC\", \"body\": \"sun\", \"body_line\": \"AC\", \"latitude_deg\": -38.661486}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"IC\", \"body\": \"mars\", \"body_line\": \"AC\", \"latitude_deg\": -45.266728}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"AC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": -46.105875}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"DC\", \"body\": \"sun\", \"body_line\": \"IC\", \"latitude_deg\": -50.110307}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"AC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": -53.107724}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"AC\", \"body\": \"mars\", \"body_line\": \"MC\", \"latitude_deg\": -54.239126}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"AC\", \"body\": \"sun\", \"body_line\": \"AC\", \"latitude_deg\": -55.724692}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"MC\", \"body\": \"moon\", \"body_line\": \"AC\", \"latitude_deg\": -56.671965}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"MC\", \"body\": \"sun\", \"body_line\": \"DC\", \"latitude_deg\": "
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data.

Ошибки

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