Загружаем песочницу
curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
-H "X-API-Key: $OCCULT_API_KEY"Аянамша — это разница между тропическим зодиаком, привязанным к равноденствию, и сидерическим зодиаком ведической астрологии, привязанным к звёздам. Она растёт примерно на пятьдесят угловых секунд в год, поэтому любой сидерический расчёт зависит от того, какую аянамшу вы принимаете и на какую дату. Этот эндпоинт возвращает именно это число. Это GET-запрос с параметрами в URL: `ayanamsa` — название, например LAHIRI, RAMAN, KRISHNAMURTI или TRUE_CITRA (принимаются 47 стандартных определений аянамши, без учёта регистра), и `date` — дата в формате ISO, по умолчанию — сегодня. С его помощью можно подписать на карте, по какой аянамше она построена, или сравнить, насколько расходятся два определения для конкретной даты рождения. Значение приходит в двух видах: `value_degrees` — десятичное число с шестью знаками после точки, а также `degrees`, `minutes` и `seconds` и готовая строка `formatted`. Название и итоговая дата тоже возвращаются в ответе. Для неизвестного названия и для псевдо-аянамши 'USER' возвращается 400.
| Параметр | Тип | Пример | Назначение | |
|---|---|---|---|---|
| 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. |