GET/api/astro/ayanamsa_value/1 кредит

Значение аянамши

Аянамша — это разница между тропическим зодиаком, привязанным к равноденствию, и сидерическим зодиаком ведической астрологии, привязанным к звёздам. Она растёт примерно на пятьдесят угловых секунд в год, поэтому любой сидерический расчёт зависит от того, какую аянамшу вы принимаете и на какую дату. Этот эндпоинт возвращает именно это число. Это GET-запрос с параметрами в URL: `ayanamsa` — название, например LAHIRI, RAMAN, KRISHNAMURTI или TRUE_CITRA (принимаются 47 стандартных определений аянамши, без учёта регистра), и `date` — дата в формате ISO, по умолчанию — сегодня. С его помощью можно подписать на карте, по какой аянамше она построена, или сравнить, насколько расходятся два определения для конкретной даты рождения. Значение приходит в двух видах: `value_degrees` — десятичное число с шестью знаками после точки, а также `degrees`, `minutes` и `seconds` и готовая строка `formatted`. Название и итоговая дата тоже возвращаются в ответе. Для неизвестного названия и для псевдо-аянамши 'USER' возвращается 400.

https://api.occultapi.com/api/astro/ayanamsa_value/

Попробовать запрос

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

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

X-API-Key: yt_live_a1b2c3d4_…

Параметры строки запроса (2)

Передаются в URL. Все необязательны, если не отмечено иное, и их можно сочетать: сначала фильтр, затем страница, затем сортировка.

Параметр	Тип		Пример	Назначение
ayanamsa	string		—	Название аянамши (например, LAHIRI). По умолчанию — LAHIRI. Параметр запроса GET. Без учёта регистра: .strip.upper в. По умолчанию — 'LAHIRI'. 'USER' этот эндпоинт явно отклоняет, хотя движок эфемерид его знает. Для неизвестных значений возвращается 400 {"error": "Unknown ayanamsa..."}. одно из: FAGAN_BRADLEY, LAHIRI, DELUCE, RAMAN, USHASHASHI, KRISHNAMURTI, DJWHAL_KHUL, YUKTESHWAR, JN_BHASIN, BABYL_KUGLER1, BABYL_KUGLER2, BABYL_KUGLER3, BABYL_HUBER, BABYL_ETPSC, ALDEBARAN_15TAU, HIPPARCHOS, SASSANIAN, GALCENT_0SAG, J2000, J1900, B1950, SURYASIDDHANTA, SURYASIDDHANTA_MSUN, ARYABHATA, ARYABHATA_MSUN, SS_REVATI, SS_CITRA, TRUE_CITRA, TRUE_REVATI, TRUE_PUSHYA, GALCENT_COCHRANE, GALCENT_RGILBRAND, GALCENT_MULA_WILHELM, ARYABHATA_522, BABYL_BRITTON, TRUE_MULA, GALALIGN_MARDYKS, TRUE_SHEORAN, GALEQU_TRUE, GALEQU_MULA, GALEQU_IAU1958, GALEQU_FIORENZA, VALENS_MOON, LAHIRI_1940, LAHIRI_VP285, KRISHNAMURTI_VP291, LAHIRI_ICRC
date	string		—	Строка даты ISO (например, 1990-05-14). По умолчанию — сегодня. Ограничение ФОРМАТА, а не перечисление. Всё, что принимает datetime.fromisoformat в Python: 'YYYY-MM-DD' или полная дата-время ISO 8601, например '1990-05-14' / '1990-05-14T12:30:00'. Любое смещение часового пояса в строке ОТБРАСЫВАЕТСЯ и заменяется на UTC. По умолчанию — сегодня (UTC). При неверном формате возвращается 400.

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

curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Ответ

{
  "ayanamsa": "LAHIRI",
  "date": "2026-09-07",
  "value_degrees": 24.229844,
  "degrees": 24,
  "minutes": 13,
  "seconds": 47,
  "formatted": "24°13'47\""
}

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

Ошибки

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