# API Vedic

AstroWay API offre **354+ endpoint di astrologia vedica** — la copertura più completa di Jyotish tra le API commerciali. Classico BṚHAT-PARĀŚARA-HORĀŚĀSTRA, completo Lal Kitab, metodologia KP, Jaimini Sūtra — tutto incrociato e verificato rispetto a PyJHora.

## Cosa viene calcolato

| Categoria | Copertura |
|---|---|
| **Daśā** | 10 sistemi (Vimśottarī + 9 alternativi) × 5 livelli = **50 endpoint** |
| **Varga** | Shodasha varga D1–D60 in una singola chiamata |
| **Pañcaṅga** | Tithi, Karana, Yoga del giorno, Nakṣatra del giorno, Chogadia, Hora, Rāhu-kāla, completo |
| **Ṣaḍbala** | Forza a 6 livelli: Sthāna + Diś + Kāla + Ceṣṭa + Naisargika + Dṛk + completo |
| **Yoga** | Parāśara (Rāja, Dāna, Dharma-Karmādipatī, Pañca-Mahāpuruṣa, Gajakeśarī, Adhī) + Jaimini (karaka-yoga, karakāṃśa, śubha-graha) |
| **Doṣa** | Parāśara (Mangala, Kāla-Sarpa, Pitṛ, Śrapit, Grahaṇa, Guru-Caṇḍāla) + Lal Kitab Maṅgalik + KP |
| **Compatibilità** | Aṣṭakūṭa (8 livelli di Guna-Mīlana), Daśakoṭa, Maṅgalik-check, Maṅgala-mec, Bṛgu-mec |
| **Muhūrta** | Elettivo — matrimonio, auto, business, viaggio, fidanzamento, operazione, istruzione, investimenti, immobili, gṛha-praveśa, fidanzamento, processo legale |
| **Lal Kitab** | Pacchetto completo: carta natale, graha, ṛṣi, tattva, varga, upāya |
| **KP** | Krishnamurti Paddhati con pianeti reggenti, teoria dei sub-lord, yoga/doṣa KP |
| **Jaimini** | Karaka, cara-karaka, pada, upapada, aspetti, dṛṣṭi, Ātmakaraka-Navamśa, Daha-summary, Yoga + extra: karaka-yoga, karakāṃśa, atmakaraka-rotation, argala-analysis |

## Esempio: Daśā Vimśottarī

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
      -H "X-Api-Key: aw_live_tua_chiave_qui" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "tzOffset": "+03:00",
        "latitude": 50.4501,
        "longitude": 30.5234
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/vedic/dashas/vimshottari/maha', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-07-14',
        time: '14:30:00',
        tzOffset: '+03:00',
        latitude: 50.4501,
        longitude: 30.5234,
      }),
    });
    const { data } = await r.json();
    console.log(`MD corrente: ${data.current.lord} fino al ${data.current.endDate}`);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/vedic/dashas/vimshottari/maha',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'tzOffset': '+03:00',
            'latitude': 50.4501,
            'longitude': 30.5234,
        },
    )
    data = r.json()['data']
    print(f"MD corrente: {data['current']['lord']} fino al {data['current']['endDate']}")
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('vedic/dashas/vimshottari/maha', [
        'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
        'json' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'tzOffset' => '+03:00',
            'latitude' => 50.4501,
            'longitude' => 30.5234,
        ],
    ]);
    $data = json_decode($r->getBody(), true)['data'];
    echo "MD corrente: {$data['current']['lord']} fino al {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Funzionalità uniche

Endpoint che non trovi da nessun'altra parte:

- **10 sistemi di daśā** incluse le rare Tribhagi, Śatābdika, Ṣoḍaśottarī, Sthira, Śūla (la maggior parte delle API offre solo Vimśottarī)
- **Karakāṃśa come carta natale in 12 case** — proiezione completa con iṣṭa-devatā + valori mokṣa
- **Analisi Argala** — scansione completa di Argala + Virodhārgalā su 12 case con metrica netInfluence
- **Atmakaraka-rotation** — progressione di AK lungo la vita con trigger di eventi di vita
- **Cross-school doṣa** — Parāśara + Lal Kitab + KP in una singola API (la maggior parte offre solo una scuola)

## Chi lo usa

- **App di astrologia indiana** (Pratyangira, Drik Panchang, AstroSage e simili) — backend completo senza bisogno di gestire le effemeridi in autonomia
- **Servizi di compatibilità matrimoniale** — Aṣṭakūṭa + Daśakoṭa + Maṅgalik in una singola chiamata
- **App di oroscopi mobili** — Pañcaṅga quotidiano tramite `/v1/vedic/panchang/full` (8 elementi in 1 richiesta)
- **Servizi elettivi** (fidanzamento di un bambino, muhūrta per matrimonio) — `/v1/vedic/muhurat/*` per 12 tipi di eventi
- **Servizi di compatibilità vedica** — report completo tramite `/v1/vedic/compatibility/full`

## Precisione

Tutti i calcoli si basano su **Swiss Ephemeris** (precisione sub-arcosecondo) + incrociati con **PyJHora** (implementazione di riferimento de facto in Python). Le discrepanze, dove presenti, sono documentate in `docs/AUDIT-TRAIL.md`.

Le scuole con tradizioni diverse (Lal Kitab, KP, Jaimini) hanno endpoint contrassegnati con **etichette GIALLE** per quelli che utilizzano metodi di un singolo autore (ad esempio Lal Kitab — solo Pt. Roop Chand Joshi) — l'integratore vede il livello di canonicità.

## Localizzazione

I report vedici sono disponibili in **20 lingue** (T0 manuale, T1 AI Beta — vedi [`/languages/`](/languages/)). Passa `lang=<code>` a qualsiasi endpoint `/v1/reports/*`.

## Prezzi

La maggior parte degli endpoint vedici sono **Tier 2 (20 crediti)**. Report più grandi (compatibilità completa, scanner muhūrta) sono Tier 3 (50 crediti). I report PDF di Lal Kitab / Vedic Kundli sono Tier 7 (5000 crediti).

Con il piano Free hai **500 chiamate vediche al mese gratis**.

<CardGrid>
  <LinkCard title="Categorie di endpoint →" href="/vedic/" description="Daśā, Varga, Pañcaṅga, Ṣaḍbala, Yoga, Doṣa, Compatibilità, Muḥūrta" />
  <LinkCard title="Guida rapida" href="/getting-started/" description="Fai la tua prima richiesta in 5 minuti" />
  <LinkCard title="Prezzi" href="/pricing/" description="Dal piano Free a quello Enterprise" />
  <LinkCard title="Supporto lingue" href="/languages/" description="20 lingue — report vedici" />
</CardGrid>