Jaimini-estensioni: 5 nuovi endpoint per analisi Vedic approfondite

Jaimini Sutras - una scuola separata di astrologia Vedic con il proprio strumento sopra il sistema standard Parashara: chara karakas al posto dei segni fissi, sistemi dasha sui segni, padas, argala. Quasi tutte le astrology-API pubbliche si limitano al set Parashara - noi aggiungiamo cinque endpoint specifici Jaimini, precedentemente rimandati come funzionalità deep‑niche.

Tutti e cinque sono endpoint completi con test snapshot di regressione, non wrapper AI.

Chara karakas (segni mobili) sono 8 pianeti, ordinati per grado nel segno (senza considerare il segno): Atmakaraka, Amatyakaraka, Bhratrukaraka, Matrukaraka, Putrakaraka, Gnatikaraka, Darakaraka, e opzionalmente l’8°. L’endpoint scansiona tutti e 8 con una valutazione della forza di posizionamento (kendra / trine / dusthana) e restituisce un suggerimento di manifestazione per ciascuno.

curl -X POST https://api.astroway.info/v1/vedic/yogas/jaimini/karaka-yoga \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52
  }'

Use case. Stai costruendo un prodotto di consulenza Vedic - il cliente vuole sapere “chi sono nell’anima / nella professione / nel partner”. Karaka Yoga restituisce subito 8 assi native con il placement score, non devi estrarre manualmente l’array planets e ordinarlo per grado.

Karakamsa Lagna è il segno in cui si trova Atmakaraka nel D9 Navamsha. Da esso si costruisce una proiezione completa a 12 case con i valori canonici di ciascuna casa: 1° - iṣṭa devata (dio personale), 5° - mantra/pratica spirituale, 12° - moksha e karma trascurata.

curl -X POST https://api.astroway.info/v1/vedic/yogas/jaimini/karakamsa \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }'

La risposta contiene la suddivisione completa a 12 case con i pianeti in ciascuna casa, il valore per casa e un suggerimento sul tema dominante (ad esempio, “spiritual” vs “material” del natale) – basato su quali pianeti popolano le case chiave 1/5/9/12.

Fonte delle regole. Le signification canoniche per karakamsa provengono dal commento di Sanjay Rath ai Jaimini Sutras. Non è la nostra interpretazione – è una tradizione citata.

L’analisi standard Parashara fornisce “natural benefic / malefic” – Giove è sempre benefico, Saturno è sempre malefico. Questo è il livello base. La natura funzionale dipende dal possesso delle case dal Lagna del natale specifico. L’endpoint restituisce la categoria per ciascuno dei 7 pianeti visibili:

• yogakaraka: possiede sia kendra sia trine contemporaneamente (ad esempio, Marte per Cancer Lagna)
• functional-benefic: possiede trine (5/9)
• neutral: altre configurazioni
• functional-malefic: possiede dusthana (6/8/12)
• maraka: possiede 2/7, potenziale killer‑signifier

Le regole sono tratte da BPHS A.34 – Kendradhipati Dosha + regole Maraka.

curl -X POST https://api.astroway.info/v1/vedic/yogas/jaimini/shubha-graha \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }'

Use case. Prima di interpretare il periodo dasha, devi sapere se il pianeta del periodo è yogakaraka o maraka per il natale specifico. Questo endpoint fornisce quel contesto in una singola chiamata, senza mappatura manuale della house‑rulership.

Atmakaraka è il pianeta più alto per grado nel segno – formalmente statico. Ma grazie alla progressione simbolica 1°/anno le posizioni di tutti i chara karakas si spostano lentamente, e in alcuni anni Atmakaraka cambia (un pianeta con grado minore supera il leader formale tramite il movimento simbolico).

L’endpoint restituisce una timeline di questi passaggi per tutta la vita – utile per la narrazione della life‑mission.

curl -X POST https://api.astroway.info/v1/vedic/jaimini/atmakaraka-rotation \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }'

Response – array di eventi con age_at_transition, planet_before, planet_after. È Tier 3 (50 credits) – il calcolo time‑series è più costoso di uno snapshot singolo.

Argala (blocco, “intervention”) – meccanismo Jaimini di supporto/blocco di una casa tramite l’occupazione di certe distanze. Scansione completa:

• Primary Argala: 2/4/11 dalla casa target
• Secondary Argala: 5 dalla casa target
• Special Argala: 8 dalla casa target
• Virodhargala (opposizione ad argala): 12/10/3 primary, 9 secondary, 6 special

L’endpoint restituisce il net‑influence per ciascuna delle 12 case + dominant‑over (chi domina – argala o virodhargala) per ogni casa.

curl -X POST https://api.astroway.info/v1/vedic/jaimini/argala-analysis \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }'

Use case. Interprete consulente Vedic in modalità hard. Prima della previsione per una casa – verifica se la configurazione argala supporta il tema o se virodhargala lo blocca. Questo è il livello di analisi che solitamente richiede più di 30 minuti di lavoro manuale in Jagannatha Hora – qui ottieni una risposta strutturata.

Tutti e cinque sono disponibili tramite Vedic Pack add‑on ($9/mese oltre il piano base). Le chiamate singole funzionano anche in modalità Pay‑as‑you‑go.

Tutti e cinque gli schemi sono in /v1/openapi.json. Il prossimo rilascio codegen SDK (TS / Python / PHP) aggiungerà metodi tipizzati sotto il namespace vedic.jaimini.*. Le roadmap sono nei relativi repository di staging.

Il segmento Vedic nel developer‑tooling è fortemente underbuilt: quasi tutte le API pubbliche forniscono solo Vimshottari + planets‑in‑signs. Chi vuole Jaimini deve integrare un software desktop separato (Jagannatha Hora, Parashara’s Light) o scrivere il proprio wrapper SwissEph.

Questi cinque endpoint colmano un gap specifico – la scuola Jaimini è ora consumabile via HTTP proprio come la carta natale. La documentazione per ciascuno è in /docs/api/ → Vedic.