Vedic FAQ

Tento obsah zatím není dostupný ve vašem jazyce.

Зібрані питання, які часто виникають при інтеграції ведичних ендпоінтів. Якщо не знайшли відповідь - пишіть на hello@astroway.info, додамо.

Які айянамші підтримуються? Яку обрати?

API підтримує 9 айянамш:

Код	Назва	Коли обирати
`lahiri` (default)	Чітра-Пакша	Стандарт уряду Індії; найбільший масовий ринок. Для більшості Vedic-застосунків - це.
`raman`	B.V. Raman	Якщо інтегруєте мобільний застосунок для південноіндійського ринку (Karnataka, Tamil Nadu).
`krishnamurti` (аліас `kp`)	KP	Якщо викликаєте `/v1/vedic/kp/*` - KP має власну айянамшу.
`yukteshwar`	Sri Yukteshwar	Distance from Spica; theosophical / Western-leaning audiences.
`fagan-bradley`	Fagan/Bradley	Western sidereal (не Vedic). Для астрологів які мігрують з sidereal-Western traditions.
`de-luce`	De Luce	Старіша astrologists’ choice, рідка.
`jn-bhasin`	JN Bhasin	Специфічна школа, рідка.
`true-citra`	True Chitra Paksha	Спіка жорстко на 0° Терезів. Від Lahiri розходиться на 0.01°, тобто беріть її тільки якщо потрібна саме зіркова прив’язка.
`djwhal-khul`	Djwhal Khul	Теософська школа, рідкісна. Найбільший відхил у таблиці.

Основні школи розходяться мало: Lahiri, True Chitra і KP тримаються в межах 0.1°, Fagan/Bradley, JN Bhasin, Yukteshwar і Raman - до 1.45°. Осторонь стоять De Luce (3.96° від Lahiri) і Djwhal Khul (3.82°), і на них позиція біля межі знаку вже переїжджає в сусідній знак. Заміряно 2026-08-18 по Місяцю однієї карти; на degree-based техніках (Nakshatra position, Argala) різниця видно навіть у межах 0.1°.

Sidereal чи tropical? Що повертає API?

За замовчуванням Vedic-ендпоінти повертають сайдеричні позиції (зодіак прив’язаний до зірок, з застосованою айянамшею). Західні ендпоінти (/v1/chart, /v1/synastry) повертають тропічні (зодіак прив’язаний до точки рівнодення).

Тропічного Vedic (рідкісний edge-case, який пропонують Sanjay Rath і Ernst Wilhelm) API не віддає: усі ведичні ендпоінти рахують сайдерично і zodiacType у тілі запиту ігнорують. Тропічні позиції дає західна гілка (/v1/chart, /v1/synastry), а zodiacType: "sidereal" перемикає її у сайдеричний зодіак з тією ж айянамшею.

Яка школа коли використовується?

Школа	Регіон / Аудиторія	Сильна сторона
Parashara (BPHS)	Весь Vedic-світ - universal baseline	Найповніший корпус техник; завжди start here
Jaimini	Tamil Nadu + advanced practitioners	Karaka-based predictions; AK-driven life themes
Lal Kitab	Punjab + North India	Уніcal remedies (упайя), Manglik-spec
KP (Krishnamurti)	Tamil Nadu + Andhra Pradesh	Sub-lord theory, precision in event-timing

Pratyangira, AstroSage та інші великі апи дають здебільшого Parashara. AstroWay покриває всі чотири через окремі ендпоінт-групи.

Ashtakoot чи Dashakoota: для якого ринку?

	Ashtakoot	Dashakoota
Регіон	North/Central Індія, Pakistan, Nepal	South Індія (Tamil Nadu, Karnataka, Kerala)
Шкала	36 балів max	10 кут (factors)
Складові	Varna + Vashya + Tara + Yoni + Graha Maitri + Gana + Bhakoot + Nadi	Дина + Гана + Махендра + Стрі-Дірга + Йоні + Раши + Раши-аадхипатхи + Вашіа + Раджу + Ведха
API	`/v1/vedic/compatibility/ashtakoot`	`/v1/vedic/compatibility/dashakoota`

Якщо метчмейкер обслуговує всю Індію - викликайте /v1/vedic/compatibility/full - отримуєте обидва + Manglik + Bhrigu.

Mangal Dosha: чому це важливо?

Mangal Dosha = Mars у 1/2/4/7/8/12 будинку від Lagna, Місяця, або Венери (різні школи трактують по-різному). У Індії - це диск-брейкер для шлюбу: якщо в обох партнерів Mangal-афлікція без компенсації - традиційний astrologer не дасть зеленого світла без upayas (remedies) або компенсуючих факторів.

API ендпоінт: /v1/vedic/compatibility/manglik-check - повертає { chart1: { manglik: true/false, severity, factors }, chart2: ..., compensation: ... }.

D9 (Navamsha) - чому це найважливіша варга?

D9 = 9-кратний поділ кожного знаку = детальний “soul-level” чарт. У Vedic - використовується для:

Marriage predictions: Venus + 7th lord у D9 показують справжню природу подружнього життя
Strength of planets: планета сильна в D1 але слабка в D9 = “shows but doesn’t deliver”
Vargottama: планета в одному і тому ж знаку в D1 та D9 = особлива сила

API: /v1/vedic/vargas повертає всі 16 поділів за один виклик; зосередьтесь на D9 для marriage/relationship-related фічей.

Чому час народження критичний? Що робити якщо невідомий?

Vedic дуже time-sensitive:

Lagna (Ascendant) змінюється кожні ~2 години: це ВСЯ карта зміщується
Nakshatra Місяця змінюється кожні 6–8 годин
Dasha-balance (initial period) залежить від nakshatra-position Місяця

Якщо точний час невідомий:

Sunrise chart: використовуйте 06:00 локального часу як approximation. Lagna буде Овен/Тілець для Sun у Лева/Cap; деякі Vedic-астрологи вважають sunrise charts валідними для general-tendency прогнозу
Rectification: викликайте /v1/rectification з 2-3 відомими life-events (шлюб, дитина, перенос роботи) - API повертає probable birth-time window
Disclaimer користувачу: повідомте що результати з невідомим часом: approximation, не точна карта

Які house-системи використовуються?

Vedic традиційно використовує Whole Sign houses (увесь знак = один будинок). Western - Placidus / Koch / Equal etc.

AstroWay default for Vedic = Whole Sign. Для KP-ендпоінтів - Placidus (KP-конвенція). Передавайте houseSystem параметр якщо потрібно інше: whole-sign, placidus, koch, equal, porphyry.

Чи можна змішувати Vedic + Western у одному застосунку?

Так - і це навіть рекомендоване для multi-tradition aud audiences. Architecture:

Натальна карта обчислюється один раз: Western та Vedic ендпоінти ділять той самий вхід (date/time/lat/lon)
Виведіть toggle “Western view” / “Vedic view” у вашому UI
Vedic Moon sign (раши) часто плутають з Western Sun sign: попередьте користувача про різницю
Compatibility: можете показати ОБИДВА: Western synastry + Vedic Ashtakoot одночасно

API ендпоінт /v1/compat/astro-vedic робить це автоматично - Western synastry × Vedic Ashtakoot bridge.

Який ephemeris використовується? Наскільки точно?

Swiss Ephemeris (LGPL) - той самий, що в Solar Fire, Kepler, Astro Gold, Janus, AstroSeek. Точність:

Планетарні позиції: ±1 кутова секунда vs NASA JPL ephemeris
Куспіди будинків: ±1 кутова мінута
Айянамша: Lahiri-table cross-validated проти official Indian government tables

Для Vedic-специфічних обрахунків (Nakshatra-position, Vimshottari balance, Vargas) - крос-перевірено проти PyJHora (de-facto Python reference); розбіжності < 0.01° де є. Звіт по розбіжностях - docs/AUDIT-TRAIL.md репо.

Чи можу я кешувати результати? Як?

Так - більшість Vedic-ендпоінтів детерміністичні для одного і того ж вхідного chart-input. Stable cache key: hash(date + time + lat + lon + ayanamsa + endpoint).

API також пропонує X-Idempotency-Key header - 5-хвилинний кеш на стороні api-calc. На cache hit - кредити не списуються.

Як локалізовано тексти у відповідях?

Vedic-ендпоінти, що повертають інтерпретації (yoga descriptions, dosha meanings, muhurat reasons), приймають lang параметр. Підтримка: 20 мов (T0 - uk/en/de/ru ручно; T1 - pl/es/pt/hi/fr/ko AI Beta; T2/T3 - planned). Деталі: /languages/.

Якщо ендпоінт повертає числові дані (degrees, dates, sign indices) - вони мовно-нейтральні. Текст-fields (note, meaning, manifestation) - локалізовані.

Що робити з YELLOW-статусом?

YELLOW = ендпоінт працює, але має одну зі трьох характеристик:

Single-author school (Lal Kitab, KP): немає cross-verification з іншими школами, бо їх не існує
Scoring/heuristic-based (compatibility 0-100, breakup-timing): числова оцінка subjective за природою
Intrinsic precision limit (rectification, Bhrigu match): алгоритм має inherent precision floor

Дивіться docs/AUDIT-TRAIL.md для конкретного ендпоінту - там написано чому YELLOW і чи є шлях до GREEN. Для більшості - ні (intrinsic), і це чесний disclaimer для інтегратора.