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

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

Аянамша — це різниця між тропічним зодіаком, прив’язаним до рівнодення, і сидеричним зодіаком ведичної астрології, прив’язаним до зір. Вона зростає приблизно на п’ятдесят кутових секунд на рік, тож результат будь-якого сидеричного розрахунку залежить від того, яку аянамшу ви взяли і на яку дату. Цей ендпоінт повертає саме це число. Запит — GET, параметри передаються в рядку запиту: `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. Детальніше — у довіднику помилок.