Astrologia Vedic tramite API: da Parashara a Lal Kitab in 354 endpoint

L’astrologia Vedic è la tradizione astrologica continua più antica del mondo. Le sue tecniche formali (BPHS, Jaimini Sutras, Lal Kitab, KP) vengono utilizzate ogni giorno in India: per gli appuntamenti di matrimonio, la scelta delle date, la diagnosi proattiva del destino. Ma raggiungere calcoli di qualità a livello di programmazione - fino a poco tempo fa era un problema.

AstroWay v2.19 risolve questo problema: 354+ endpoint Vedic, verificati incrociatamente con PyJHora (implementazione di riferimento Python), con divergenze documentate.

Sebbene entrambi gli zodiaci siano calcolati dalle stesse posizioni dei pianeti (tramite Swiss Ephemeris), concettualmente sono diversi:

Vedic non è un‘“alternativa” all’astrologia occidentale - è un sistema separato con la sua logica interna. Gli integratori che creano applicazioni multi-tradizione (oroscopo mobile, appuntamenti, oroscopo quotidiano) spesso vogliono entrambi - e qui un’unica API al posto di due API esterne è un risparmio serio.

La maggior parte dei concorrenti copre solo Vimshottari (ciclo di 120 anni, il più popolare). AstroWay copre:

1. Vimshottari (120 anni) - standard BPHS, completo
2. Yogini (36 anni) - previsioni più rapide, 8 pianeti
3. Ashtottari (108 anni) - tradizione Ardradi, raccomandazione paksha
4. Kalachakra (segni come signori del MD) - sistema più complesso, paramayu varia per cartina
5. Chara (Jaimini mobile) - per previsioni basate sui segni
6. Tribhagi (54 = Vimshottari/2 + extra) - Vimshottari accelerato
7. Shatabdika (100 anni) - conteggi delle fonti variabili
8. Shodashottari (116 anni) - per cartine paksha-miste
9. Sthira (raro periodo fisso daśā)
10. Shoola (metodo cross-rasi)

Ognuno supporta 5 livelli: Maha → Antar → Pratyantar → Sookshma → Prana.

Le carte divisiorie sono viste ricorsive sulla stessa cartina natale in diverse scale. D9 (Navamsha) è la più importante per il matrimonio. D10 (Dashamsha) è la carriera. D60 (Shashtyamsha) è il livello più fine.

Una sola chiamata a /v1/vedic/vargas restituisce tutte le 16 divisioni contemporaneamente - l’integratore non deve effettuare 16 richieste separate.

5 elementi + ausiliari:

• Tithi (giorno lunare, 30 divisioni del ciclo lunare)
• Karana (mezza tithi, 11 tipi)
• Yoga (yoga del giorno, 27 tipi, basato sulla somma delle longitudini del Sole + Luna)
• Nakshatra (uno dei 27 nakshatra lunari)
• Choghadia (8 blocchi semiorari di auspiciosità)
• Hora (ora planetaria)
• Rahu-kaal (finestra inauspicia di 1,5 ore al giorno)

Chiamando /v1/vedic/panchang/full - si ottengono tutti gli 8 elementi in un unico JSON per una data e una località specifiche.

Lo yoga nella tradizione Vedic è una combinazione planetaria speciale, che forma un modello di vita significativo. Parāśara (BPHS) descrive centinaia; AstroWay implementa i più citati:

• Rāja - combinazioni di potere/riconoscimento
• Dhana - ricchezza
• Dharma-Karmadipati - percorso professionale
• Pañca-Mahāpuruṣa - Ruchaka/Bhadra/Hamsa/Malavya/Śaśa (5 pianeti nelle case kendra nei loro segni)
• Gajakeśarī - Luna + Giove in kendra
• Adhi - Mercurio/Venere/Giove in 6/7/8 dalla Luna

Inoltre, Jaimini-specifici: karaka-yoga (8 chara-karaka in case significative), karakāṃśa (proiezione della 12a casa con AK in D9), śubha-graha (benefico funzionale per BPHS Adhyaya 34).

Doṣa è un afflitto planetario, che complica una sfera specifica della vita. AstroWay copre tre scuole:

• Parāśara: Mangal Doṣa (Marte), Kāl Sarp (pianeti tra Rahu e Ketu), Pitru (karma degli antenati), Śrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (interpretazione specifica di Lal Kitab), più altri doṣa unici di questa scuola
• KP (Krishnamurti Paddhati): diagnostica basata sul sub-signore

Se il tuo appuntamento di matrimonio serve clienti da diverse regioni dell’India (Punjab spesso utilizza LK, Tamil Nadu - KP, tutti - Parāśara) - un’unica API al posto di tre.

Il processo classico di appuntamento indiano:

1. Aṣṭakūṭa (Guna Milan) - scala a 8 punti, 36 punti massimi. Meno di 18 = bassa compatibilità. Più popolare nel Nord/Centro India.
2. Daśakūṭa - scala a 10 punti, variante del Sud India.
3. Controllo Manglik - critico per le cartine natali afflitte da Marte.
4. Abbinamento Mangal - compensa Marte-Marte.
5. Abbinamento Bhrigu - sovrapposizione predittiva da Bhrigu Samhita.

Tutti tramite /v1/vedic/compatibility/full - un’unica chiamata, rapporto completo di compatibilità.

“Muhūrta” è il momento auspiciale per avviare un evento. Eventi classici:

• Muhūrta di matrimonio (matrimonio)
• Acquisto di veicoli (auto)
• Avvio di un’attività (apertura di un’attività)
• Viaggio (viaggio)
• Cerimonia di nomina (Namakaran - nomina di un neonato)
• Chirurgia, inizio dell’istruzione, investimento, acquisto di proprietà, griha-pravesh (nuova casa), fidanzamento, cause legali

/v1/vedic/muhurat/{evento} restituisce le prime 3 date auspicievoli nell’intervallo di tempo specificato.

Lahiri è il valore predefinito (Chitra-Paksha, standard ufficiale del governo indiano). Tramite il parametro ayanamsa è possibile commutare:

• raman - tradizione B.V. Raman (popolare in KP)
• krishnamurti - specifico di KP
• yukteshwar - Sri Yukteshwar (distanza da Spica)
• fagan-bradley - Fagan/Bradley (sidereale occidentale)
• de-luce - De Luce
• jn-bhasin - JN Bhasin

Ognuno è un offset diverso (di solito 23,5-24,0°). Per lo stesso cliente, le posizioni dei pianeti nei segni possono differire - è importante saperlo già nella fase di progettazione dell’applicazione.

Ogni endpoint ha:

• Stato (VERDE/GIALLO) in docs/AUDIT-TRAIL.md
• Intestazione AUDIT in linea nel codice sorgente con fonti (BPHS Adhyaya N, Jaimini Sutras X.Y, funzione di riferimento PyJHora)
• Fixture di test per snapshot per regressioni

Le divergenze con PyJHora (dove presenti - più spesso per metodiche a singolo autore come Lal Kitab) sono documentate in AUDIT-TRAIL - l’integratore vede la differenza esatta prima di integrare.

# Carta natale 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
  }'

Restituisce il signore Maha-dasha attuale, la data di fine MD, la sequenza delle dasha successive. Tramite /maha → /antar → /pratyantar → … è possibile approfondire fino a 5 livelli.

I rapporti Vedic (PDF) sono disponibili in 20 lingua incluse hi, ko, ja, id, tr, vi - mercati con una reale domanda di contenuti Vedic. È possibile passare lang=<codice> in qualsiasi endpoint /v1/reports/*. Dettagli - /languages/.

La maggior parte degli endpoint Vedic è Tier 2 (20 crediti). Nel piano gratuito - 500 chiamate Vedic al mese. I rapporti completi (compatibilità completa, scanner muhurat) - Tier 3 (50 cr). I rapporti PDF Vedic Kundli / Lal Kitab - Tier 7 (5000 cr).

• Categorie endpoint Vedic - navigazione per 8 gruppi
• Marketing API Vedic - panoramica completa con esempi di codice in 4 lingue
• Avvio rapido - prima richiesta in 5 minuti
• Prezzi - dal piano gratuito al piano Enterprise