curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
-H "X-API-Key: $OCCULT_API_KEY"Аянамша — це різниця між тропічним зодіаком, прив’язаним до рівнодення, і сидеричним зодіаком ведичної астрології, прив’язаним до зір. Вона зростає приблизно на п’ятдесят кутових секунд на рік, тож результат будь-якого сидеричного розрахунку залежить від того, яку аянамшу ви взяли і на яку дату. Цей ендпоінт повертає саме це число. Запит — GET, параметри передаються в рядку запиту: `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. |