Vedic-астрологія через API: від Парашари до Лал Кітаб у 354 ендпоінтах

Vedic-астрологія - найдавніша безперервна астрологічна традиція світу. Її формальні методики (БПХС, Джайміні-сутри, Лал Кітаб, KP) використовуються щодня в Індії: для весільних метчмекерів, виборів дат, проактивної діагностики долі. Але програмно дістатися до якісних обчислень - донедавна було боляче.

AstroWay v2.19 виправляє це: 354+ Vedic-ендпоінтів, перехресно перевірених проти PyJHora (Python-референс імплементація), з документованими розбіжностями.

Хоч обидва зодіаки розраховуються від тих самих позицій планет (через Swiss Ephemeris), концептуально вони відмінні:

Vedic не “альтернатива” західній - це окрема система з власним внутрішнім логічним каркасом. Інтегратори, які роблять multi-tradition застосунки (мобільний гороскоп, мечмейкер, daily horoscope), часто хочуть обидва - і тут одне API замість двох сторонніх - серйозна економія.

Більшість конкурентів - лише Vimshottari (120-річний цикл, найпопулярніший). AstroWay покриває:

1. Vimshottari (120 років): стандарт BPHS, наскрізна
2. Yogini (36 років): швидші передбачення, 8 планет
3. Ashtottari (108 років): Ardradi tradition, паkша-рекомендація
4. Kalachakra (signs-as-MD-lords): найскладніша система, paramayu varies per chart
5. Chara (Jaimini movable): для сign-based передбачень
6. Tribhagi (54 = Vimshottari/2 + extras): accelerated Vimshottari
7. Shatabdika (100 років): varied source-counts
8. Shodashottari (116 років): для paksha-mixed charts
9. Sthira (рідкісна fixed-period dasha)
10. Shoola (cross-rasi method)

Кожна підтримує 5 рівнів: Maha → Antar → Pratyantar → Sookshma → Prana.

Дивізійні карти - це рекурсивні погляди на ту саму натальну карту в різних масштабах. D9 (Navamsha) - найважливіша для шлюбу. D10 (Dashamsha) - кар’єра. D60 (Shashtyamsha) - найтонший рівень.

Один виклик до /v1/vedic/vargas повертає всі 16 поділів за раз - інтегратор не повинен робити 16 окремих запитів.

5 елементів + допоміжні:

• Tithi (місячний день, 30 ділень місячного циклу)
• Karana (півтітхі, 11 типів)
• Yoga (day-yoga, 27 типів, базується на сумі довгот Сонця + Місяця)
• Nakshatra (одне з 27 місячних мансій)
• Choghadia (8 півгодинних блоків auspiciousness)
• Hora (планетна година)
• Rahu-kaal (інауспіційний 1.5-годинний window щодня)

Викликаючи /v1/vedic/panchang/full - отримуєш все 8 елементів в одному JSON для конкретної дати/локації.

Йога в Vedic - це спеціальна планетна комбінація, що утворює помітний life-pattern. Парашара (BPHS) описує сотні; AstroWay реалізує найбільш цитовані:

• Раджа: комбінації влади/визнання
• Дана: багатства
• Дхарма-Кармадіпаті: професійний шлях
• Панча-Махапуруша: Ручака/Бхадра/Хамса/Малавія/Шаша (5 планет у kendra-домах у власних знаках)
• Гаджакесарі: Місяць + Юпітер у kendra
• Адхі: Меркурій/Венера/Юпітер у 6/7/8 від Місяця

Плюс Jaimini-специфічні: karaka-yoga (8 чара-карак у значимих будинках), karakamsa (12-house projection з АК у D9), shubha-graha (functional benefic per BPHS Adhyaya 34).

Doша - це планетна аффлікція, що ускладнює конкретну сферу життя. AstroWay покриває три школи:

• Парашара: Mangal Dosha (Mars), Kaal Sarp (планети між Rahu і Ketu), Pitru (предкова karma), Shrapit, Grahan, Guru-Chandal
• Лал Кітаб: Manglik (специфічна для Lal Kitab інтерпретація), плюс інші unique-доші цієї школи
• KP (Krishnamurti Paddhati): sub-lord-based diagnostics

Якщо ваш мечмейкер обслуговує клієнтів з різних регіонів Індії (Punjab часто використовує LK, Tamil Nadu - KP, всі - Парашара) - одне API замість три.

Класичний індійський метч-процес:

1. Ashtakoot (Guna Milan): 8-кратна шкала, 36 балів максимум. Менш ніж 18 = низько сумісно. Найпопулярніший в North/Central Індії.
2. Dashakoota: 10-кратна, South Indian variant.
3. Manglik check: критичний для Mars-афліктованих натальних карт.
4. Mangal match: компенсує Mars-Mars.
5. Bhrigu match: predictive overlay з Bhrigu Samhita.

Всі через /v1/vedic/compatibility/full - одне виклик, повний звіт сумісності.

“Мухурта” - аустіційний момент часу для запуску події. Класичні події:

• Marriage muhurta (весілля)
• Vehicle purchase (auto)
• Business start (відкриття бізнесу)
• Travel (подорожі)
• Naming ceremony (Namakaran: наречення немовляти)
• Surgery, education start, investment, property purchase, griha-pravesh (новосілля), engagement, court cases

/v1/vedic/muhurat/{event} повертає top-3 авспіційні дати в заданому range.

Lahiri - default (Чітра-Пакша, official Indian government стандарт). Через ayanamsa параметр можна перемикнути:

• raman: B.V. Raman tradition (popular у KP)
• krishnamurti: KP-specific
• yukteshwar: Sri Yukteshwar (відстань від Spica)
• fagan-bradley: Fagan/Bradley (western sidereal)
• de-luce: De Luce
• jn-bhasin: JN Bhasin

Кожна - це різний offset (зазвичай 23.5–24.0°). Для одного і того ж клієнта позиції планет у знаках можуть відрізнятися - це важливо знати ще на стадії architecture свого застосунку.

Кожен ендпоінт має:

• Status (GREEN/YELLOW) в docs/AUDIT-TRAIL.md
• Inline-AUDIT заголовок у вихідному коді з джерелами (BPHS Adhyaya N, Jaimini Sutras X.Y, PyJHora reference function)
• Snapshot-test fixture для регресій

Розбіжності з PyJHora (де є - найчастіше для single-author методик типу Lal Kitab) задокументовані в AUDIT-TRAIL - інтегратор бачить точний delta до того як інтегрувати.

# Натальна Vedic-карта
curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Повертає поточний Maha-dasha lord, кінцеву дату MD, sequence наступних дашей. Через /maha → /antar → /pratyantar → … можна заглиблюватися до 5 рівня.

Vedic-репорти (PDF) доступні 20 мовами включно з hi, ko, ja, id, tr, vi - ринками з реальним demand для Vedic-контенту. Передавайте lang=<code> у будь-який /v1/reports/* ендпоінт. Деталі - /languages/.

Vedic-ендпоінти коштують 10, 20 або 50 кредитів залежно від того, що рахують: Лал Кітаб і КП - 10, варги й елементи панчангу - 20, доші Парашара, даші, шадбала й мухурта - 50. На безкоштовному тарифі (10 000 кредитів) це від 200 до 1000 Vedic-викликів на місяць. PDF-репорти Vedic Kundli / Lal Kitab - 5000.

• Категорії Vedic-ендпоінтів: навігація по 8 групам
• Vedic API marketing: повний огляд з прикладами коду на 4 мовах
• Швидкий старт: перший запит за 5 хвилин
• Тарифи: від безкоштовного до Enterprise