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",
    "tzOffset": "+03:00",
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

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

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

Більшість Vedic-ендпоінтів — Tier 2 (20 кредитів). На безкоштовному тарифі — 500 Vedic-викликів на місяць. Великі звіти (full compatibility, muhurat-scanner) — Tier 3 (50 cr). PDF-репорти Vedic Kundli / Lal Kitab — Tier 7 (5000 cr).

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