L'astrologie védique via API : de Parashara au Lal Kitab en 354 endpoints

L’astrologie védique est la plus ancienne tradition astrologique ininterrompue au monde. Ses méthodes formelles (BPHS, Jaimini Sutras, Lal Kitab, KP) sont utilisées chaque jour en Inde : par les marieurs, pour le choix des dates, pour un diagnostic proactif du destin. Mais accéder par programmation à des calculs de qualité était, jusqu’à récemment, pénible.

AstroWay v2.19 corrige cela : plus de 354 endpoints védiques, vérifiés de manière croisée avec PyJHora (l’implémentation de référence en Python), avec des écarts documentés.

Même si les deux zodiaques se calculent à partir des mêmes positions planétaires (via Swiss Ephemeris), ils diffèrent sur le plan conceptuel :

Le védique n’est pas une “alternative” à l’occidental : c’est un système à part entière avec sa propre charpente logique. Les intégrateurs qui construisent des applications multi-traditions (horoscope mobile, matchmaking, horoscope quotidien) veulent souvent les deux, et une seule API au lieu de deux fournisseurs tiers représente une économie sérieuse.

La plupart des concurrents se limitent à Vimshottari (cycle de 120 ans, le plus populaire). AstroWay couvre :

1. Vimshottari (120 ans) : standard BPHS, universel
2. Yogini (36 ans) : prédictions plus rapides, 8 planètes
3. Ashtottari (108 ans) : tradition Ardradi, recommandation selon le paksha
4. Kalachakra (signes comme seigneurs de MD) : le système le plus complexe, le paramayu varie selon la carte
5. Chara (Jaimini, mobile) : pour les prédictions basées sur les signes
6. Tribhagi (54 = Vimshottari/2 + compléments) : Vimshottari accéléré
7. Shatabdika (100 ans) : décomptes variables selon les sources
8. Shodashottari (116 ans) : pour les cartes à paksha mixte
9. Sthira (dasha rare à périodes fixes)
10. Shoola (méthode cross-rasi)

Chacun prend en charge 5 niveaux : Maha → Antar → Pratyantar → Sookshma → Prana.

Les cartes divisionnaires sont des vues récursives de la même carte natale à différentes échelles. D9 (Navamsha) est la plus importante pour le mariage. D10 (Dashamsha) concerne la carrière. D60 (Shashtyamsha) est le niveau le plus fin.

Un seul appel à /v1/vedic/vargas renvoie les 16 divisions d’un coup : l’intégrateur n’a pas à faire 16 requêtes séparées.

5 éléments + auxiliaires :

• Tithi (jour lunaire, 30 divisions du cycle lunaire)
• Karana (demi-tithi, 11 types)
• Yoga (day-yoga, 27 types, basé sur la somme des longitudes du Soleil + de la Lune)
• Nakshatra (l’une des 27 demeures lunaires)
• Choghadia (le jour et la nuit, 8 blocs d’auspiciousness chacun, d’environ une heure et demie)
• Hora (heure planétaire)
• Rahu-kaal (fenêtre inauspicieuse de 1,5 heure chaque jour)

En appelant /v1/vedic/panchang/full, vous obtenez les 8 éléments dans un seul JSON pour une date et un lieu donnés.

En védique, un yoga est une combinaison planétaire particulière qui forme un schéma de vie marquant. Parashara (BPHS) en décrit des centaines ; AstroWay implémente les plus cités :

• Raja : combinaisons de pouvoir et de reconnaissance
• Dhana : richesse
• Dharma-Karmadhipati : parcours professionnel
• Pancha-Mahapurusha : Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 planètes en maisons kendra dans leur propre signe)
• Gajakesari : Lune + Jupiter en kendra
• Adhi : Mercure/Vénus/Jupiter en 6/7/8 à partir de la Lune

Plus les spécificités Jaimini : karaka-yoga (8 chara-karakas dans des maisons significatives), karakamsa (projection sur 12 maisons avec l’AK en D9), shubha-graha (bénéfique fonctionnel selon BPHS Adhyaya 34).

Un dosha est une affliction planétaire qui complique un domaine précis de la vie. AstroWay couvre trois écoles :

• Parashara : Mangal Dosha (Mars), Kaal Sarp (planètes entre Rahu et Ketu), Pitru (karma ancestral), Shrapit, Grahan, Guru-Chandal
• Lal Kitab : Manglik (interprétation propre au Lal Kitab), plus d’autres doshas propres à cette école
• KP (Krishnamurti Paddhati) : diagnostic fondé sur les sub-lords

Si votre service de matchmaking sert des clients de différentes régions de l’Inde (le Pendjab utilise souvent le LK, le Tamil Nadu le KP, et tout le monde Parashara), c’est une seule API au lieu de trois.

Le processus de matching indien classique :

1. Ashtakoot (Guna Milan) : échelle en 8 critères, 36 points au maximum. Moins de 18 = faible compatibilité. Le plus répandu dans le nord et le centre de l’Inde.
2. Dashakoota : 10 critères, variante du sud de l’Inde.
3. Manglik check : crucial pour les cartes natales affligées par Mars.
4. Mangal match : compense Mars-Mars.
5. Bhrigu match : superposition prédictive issue de la Bhrigu Samhita.

Tout passe par /v1/vedic/compatibility/full : un seul appel, un rapport de compatibilité complet.

Le “muhurta” est un moment propice pour lancer un événement. Événements classiques :

• Marriage muhurta (mariage)
• Vehicle purchase (achat d’un véhicule)
• Business start (ouverture d’une entreprise)
• Travel (voyages)
• Naming ceremony (Namakaran : attribution du nom au nouveau-né)
• Surgery, education start, investment, property purchase, griha-pravesh (pendaison de crémaillère), engagement, court cases

/v1/vedic/muhurat/{event} renvoie les 3 meilleures dates propices dans l’intervalle demandé.

Lahiri est la valeur par défaut (Chitra-Paksha, standard officiel du gouvernement indien). Le paramètre ayanamsa permet de changer :

• raman : tradition de B.V. Raman (populaire en KP)
• krishnamurti : propre au KP
• yukteshwar : Sri Yukteshwar (distance à Spica)
• fagan-bradley : Fagan/Bradley (sidéral occidental)
• de-luce : De Luce
• jn-bhasin : JN Bhasin

Chacune correspond à un décalage différent (généralement 23,5–24,0°). Pour un même client, les positions des planètes dans les signes peuvent différer : c’est à savoir dès la phase d’architecture de votre application.

Chaque endpoint dispose :

• d’un Status (GREEN/YELLOW) dans docs/AUDIT-TRAIL.md
• d’un en-tête AUDIT inline dans le code source avec les sources (BPHS Adhyaya N, Jaimini Sutras X.Y, fonction de référence PyJHora)
• d’une fixture de snapshot-test contre les régressions

Les écarts avec PyJHora (quand il y en a, le plus souvent pour des méthodes d’un seul auteur comme le Lal Kitab) sont documentés dans AUDIT-TRAIL : l’intégrateur voit le delta exact avant d’intégrer.

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

Renvoie le seigneur de la Maha-dasha en cours, la date de fin de la MD et la séquence des dashas suivantes. Via /maha → /antar → /pratyantar → …, vous pouvez descendre jusqu’au 5e niveau.

Les rapports védiques (PDF) sont disponibles en 20 langues, dont hi, ko, ja, id, tr, vi, des marchés où la demande de contenu védique est réelle. Passez lang=<code> à n’importe quel endpoint /v1/reports/*. Détails : /languages/.

Les endpoints védiques coûtent 10, 20 ou 50 crédits selon ce qu’ils calculent : Lal Kitab et KP à 10, vargas et éléments du panchang à 20, doshas de Parashara, dashas, shadbala et muhurta à 50. Avec le forfait gratuit (10 000 crédits), cela représente de 200 à 1000 appels védiques par mois. Les rapports PDF Vedic Kundli / Lal Kitab coûtent 5000.

• Catégories d’endpoints védiques : navigation dans les 8 groupes
• Vedic API marketing : aperçu complet avec des exemples de code dans 4 langages
• Démarrage rapide : première requête en 5 minutes
• Tarifs : du gratuit à l’Enterprise