Astrologie vedică prin API: de la Parashara la Lal Kitab în 354 de endpoint-uri

Astrologia vedică este cea mai veche tradiție astrologică neîntreruptă din lume. Metodele ei formale (BPHS, sutrele Jaimini, Lal Kitab, KP) sunt folosite zilnic în India: de cei care aranjează căsătorii, pentru alegerea datelor, pentru diagnoza proactivă a destinului. Dar accesul programatic la calcule de calitate a fost, până de curând, o bătaie de cap.

AstroWay v2.19 rezolvă asta: 354+ endpoint-uri vedice, verificate încrucișat cu PyJHora (implementarea de referință în Python), cu divergențele documentate.

Deși ambele zodiace se calculează din aceleași poziții ale planetelor (prin Swiss Ephemeris), conceptual sunt diferite:

Vedicul nu este o “alternativă” la occidental - este un sistem separat, cu propriul cadru logic intern. Integratorii care fac aplicații multi-tradiție (horoscop mobil, matchmaking, horoscop zilnic) vor adesea ambele, iar aici un singur API în loc de doi furnizori externi înseamnă o economie serioasă.

Majoritatea concurenților oferă doar Vimshottari (ciclu de 120 de ani, cel mai popular). AstroWay acoperă:

1. Vimshottari (120 de ani): standardul BPHS, universal
2. Yogini (36 de ani): predicții mai rapide, 8 planete
3. Ashtottari (108 ani): tradiția Ardradi, recomandare după paksha
4. Kalachakra (semnele ca stăpâni MD): cel mai complex sistem, paramayu variază de la o hartă la alta
5. Chara (Jaimini, mobil): pentru predicții bazate pe semne
6. Tribhagi (54 = Vimshottari/2 + extras): Vimshottari accelerat
7. Shatabdika (100 de ani): număr variabil de surse
8. Shodashottari (116 ani): pentru hărți cu paksha mixtă
9. Sthira (dasha rară cu perioade fixe)
10. Shoola (metodă cross-rasi)

Fiecare suportă 5 niveluri: Maha → Antar → Pratyantar → Sookshma → Prana.

Hărțile divizionale sunt priviri recursive asupra aceleiași hărți natale, la scări diferite. D9 (Navamsha) este cea mai importantă pentru căsătorie. D10 (Dashamsha) - cariera. D60 (Shashtyamsha) - nivelul cel mai fin.

Un singur apel la /v1/vedic/vargas returnează toate cele 16 diviziuni deodată - integratorul nu trebuie să facă 16 cereri separate.

5 elemente + auxiliare:

• Tithi (ziua lunară, 30 de diviziuni ale ciclului lunar)
• Karana (jumătate de tithi, 11 tipuri)
• Yoga (day-yoga, 27 de tipuri, bazată pe suma longitudinilor Soarelui + Lunii)
• Nakshatra (una dintre cele 27 de case lunare)
• Choghadia (ziua și noaptea împărțite în câte 8 blocuri de auspiciozitate, de aproximativ o oră și jumătate fiecare)
• Hora (ora planetară)
• Rahu-kaal (fereastra neauspicioasă de 1,5 ore din fiecare zi)

Apelând /v1/vedic/panchang/full primești toate cele 8 elemente într-un singur JSON pentru o anumită dată și locație.

În astrologia vedică, o yoga este o combinație planetară specială care formează un tipar de viață vizibil. Parashara (BPHS) descrie sute; AstroWay le implementează pe cele mai citate:

• Raja: combinații de putere și recunoaștere
• Dhana: bogăție
• Dharma-Karmadhipati: drumul profesional
• Pancha-Mahapurusha: Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 planete în case kendra, în propriile semne)
• Gajakesari: Luna + Jupiter în kendra
• Adhi: Mercur/Venus/Jupiter în 6/7/8 de la Lună

Plus cele specifice Jaimini: karaka-yoga (8 chara karaka în case semnificative), karakamsa (proiecție pe 12 case cu AK în D9), shubha-graha (benefic funcțional după BPHS Adhyaya 34).

O dosha este o afecțiune planetară care complică o anumită sferă a vieții. AstroWay acoperă trei școli:

• Parashara: Mangal Dosha (Marte), Kaal Sarp (planete între Rahu și Ketu), Pitru (karma ancestrală), Shrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (interpretarea specifică Lal Kitab), plus alte dosha unice acestei școli
• KP (Krishnamurti Paddhati): diagnostic bazat pe sub-lord

Dacă serviciul tău de matchmaking are clienți din regiuni diferite ale Indiei (Punjab folosește des LK, Tamil Nadu - KP, toată lumea - Parashara), ai un singur API în loc de trei.

Procesul clasic indian de potrivire:

1. Ashtakoot (Guna Milan): scală în 8 componente, maximum 36 de puncte. Sub 18 = compatibilitate scăzută. Cel mai popular în nordul și centrul Indiei.
2. Dashakoota: în 10 componente, varianta din sudul Indiei.
3. Manglik check: critic pentru hărțile natale afectate de Marte.
4. Mangal match: compensează Marte-Marte.
5. Bhrigu match: suprapunere predictivă din Bhrigu Samhita.

Toate prin /v1/vedic/compatibility/full - un singur apel, raport complet de compatibilitate.

“Muhurta” este un moment auspicios pentru lansarea unui eveniment. Evenimentele clasice:

• Marriage muhurta (nunta)
• Vehicle purchase (mașina)
• Business start (deschiderea unei afaceri)
• Travel (călătorii)
• Naming ceremony (Namakaran: alegerea numelui nou-născutului)
• Surgery, education start, investment, property purchase, griha-pravesh (mutarea în casă nouă), engagement, court cases

/v1/vedic/muhurat/{event} returnează primele 3 date auspicioase din intervalul dat.

Lahiri este implicit (Chitra Paksha, standardul oficial al guvernului indian). Prin parametrul ayanamsa poți comuta pe:

• raman: tradiția B.V. Raman (populară în KP)
• krishnamurti: specific KP
• yukteshwar: Sri Yukteshwar (distanța față de Spica)
• fagan-bradley: Fagan/Bradley (sideral occidental)
• de-luce: De Luce
• jn-bhasin: JN Bhasin

Fiecare înseamnă un alt decalaj (de obicei 23,5–24,0°). Pentru același client, pozițiile planetelor în semne pot diferi - e bine să știi asta încă din faza de arhitectură a aplicației.

Fiecare endpoint are:

• Status (GREEN/YELLOW) în docs/AUDIT-TRAIL.md
• Un antet AUDIT inline în codul sursă, cu surse (BPHS Adhyaya N, Jaimini Sutras X.Y, funcția de referință din PyJHora)
• Un fixture de snapshot-test pentru regresii

Divergențele față de PyJHora (acolo unde există, cel mai des la metodele cu un singur autor, precum Lal Kitab) sunt documentate în AUDIT-TRAIL - integratorul vede delta exactă înainte de integrare.

# Natal Vedic chart
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
  }'

Returnează stăpânul Maha-dasha curent, data de încheiere a MD și succesiunea dasha-urilor următoare. Prin /maha → /antar → /pratyantar → … poți coborî până la nivelul 5.

Rapoartele vedice (PDF) sunt disponibile în 20 de limbi, inclusiv hi, ko, ja, id, tr, vi - piețe cu cerere reală de conținut vedic. Trimite lang=<code> în orice endpoint /v1/reports/*. Detalii - /languages/.

Endpoint-urile vedice costă 10, 20 sau 50 de credite, în funcție de ce calculează: Lal Kitab și KP - 10, varga și elementele panchang - 20, dosha Parashara, dasha, shadbala și muhurta - 50. Pe planul gratuit (10 000 de credite) asta înseamnă între 200 și 1000 de apeluri vedice pe lună. Rapoartele PDF Vedic Kundli / Lal Kitab costă 5000.

• Categorii de endpoint-uri vedice: navigare prin cele 8 grupuri
• Vedic API marketing: prezentare completă cu exemple de cod în 4 limbaje
• Pornire rapidă: prima cerere în 5 minute
• Prețuri: de la gratuit la Enterprise