# API Vedic

AstroWay API are **354+ de puncte de capăt ale astrologiei vedice** — acoperirea cea mai completă de Jyotish dintre API-urile comerciale. Clasicul BṚHAT PARĀŚARA HORĀ ŚĀSTRA, întreaga metodologie Lal Kitab, sistemul KP, Jaimini Sutras — toate sunt validate încrucișat cu PyJHora.

## Ce se calculează

| Categorie | Acoperire |
|---|---|
| **Daśa** | 10 sisteme (Vimśottarī + 9 alternative) × 5 niveluri = **50 de puncte de capăt** |
| **Varga** | Shodasha varga D1–D60 într-un singur apel |
| **Pañcāṅga** | Tithi, Karaṇa, Yoga de zi, Nakṣatra de zi, Chogadia, Hora, Rāhu-kāla, complet |
| **Ṣaḍbala** | Forța de 6 ori: Sthāna + Dig + Kāla + Cesta + Naisargika + Dṛk + complet |
| **Yoga** | Parāśara (Rāja, Dāna, Dharma-Karmādhipatī, Pañca-Mahāpuruṣa, Gajakeśarī, Adhī) + Jaimini (karaka-yoga, karakāṃśa, śubha-graha) |
| **Doṣa** | Parāśara (Māṅgala, Kāla-Sarpa, Pitṛ, Śrapit, Grahaṇa, Guru-Caṇḍāla) + Lal Kitab Māṅgala + KP |
| **Compatibilitate** | Aṣṭakūṭa (8-către Gun-Milan), Daśakoṭa, Māṅgala-cek, Maṅgala-mec, Bhṛgu-mec |
| **Muhūrta** | Electivă — căsătorie, mașină, afaceri, călătorie, naștere, operație, educație, investiții, imobiliare, gṛha-praveśa, logodnă, proces judiciar |
| **Lal Kitab** | Pachet complet: hartă, graha, ṛṣi, tattva, varga, upāya |
| **KP** | Krishnamurti Paddhati cu planete conducătoare, teoria sub-lord, yoga/dosha KP |
| **Jaimini** | Karaka, Cara-karaka, Pada, Upapada, aspecte, dṛṣṭi, Ātmākaraka-Navamśa, Daha-summary, Yoga + extras: karaka-yoga, karakāṃśa, atmākaraka-rotation, argala-analysis |

## Exemplu: Daśa 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_your_key_here" \
      -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 curent: ${data.current.lord} până la ${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 curent: {data['current']['lord']} până la {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 curent: {$data['current']['lord']} până la {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Funcționalități unice

Puncte de capăt pe care nu le vei găsi la concurenți:

- **10 sisteme de daśa** incluzând cele rare Tribhagi, Śatābdika, Ṣoḍaśottarī, Sthira, Śūla (majoritatea API-urilor au doar Vimśottarī)
- **Karakāṃśa ca hartă a casei 12** — proiecție completă cu iṣṭa-devatā + valori mokṣa
- **Argala-analysis** — scanare completă a Argalelor + Virodhargale pe 12 case cu metrica netInfluence
- **Atmākaraka-rotation** — progresie a AK pe parcursul vieții cu trigger-e de evenimente de viață
- **Cross-school doṣa** — Parāśara + Lal Kitab + KP într-un singur API (majoritatea oferă doar o singură școală)

## Cine folosește

- **Aplicații de astrologie indiană** (Pratyangira, Drik Panchang, AstroSage etc.) — backend complet fără nevoia unei efemeride proprii
- **Servicii de compatibilitate pentru căsătorie** — Aṣṭakūṭa + Daśakoṭa + Māṅgala într-un singur apel
- **Aplicații mobile de horoscop** — Pañcāṅga zilnic prin `/v1/vedic/panchang/full` (8 elemente într-o singură cerere)
- **Servicii electivă** (naștere de copil, muhūrta de nuntă) — `/v1/vedic/muhurat/*` cu 12 tipuri de evenimente
- **Servicii de compatibilitate vedică** — raport complet prin `/v1/vedic/compatibility/full`

## Precizie

Toate calculele se bazează pe **Swiss Ephemeris** (precizie sub secundă de arc) + validare încrucișată cu **PyJHora** (implementare de referință de facto în Python). Eventuale discrepanțe sunt documentate în `docs/AUDIT-TRAIL.md`.

Școlile cu tradiții diferite (Lal Kitab, KP, Jaimini) au marcaje **GALBEN** pentru punctele de capăt unde metoda este a unui singur autor (Lal Kitab — doar Pt. Roop Chand Joshi) — integratorul vede nivelul de canonicitate.

## Localizare

Rapoartele vedice sunt disponibile în **21 de limbi** (T0 manual, T1 AI Beta — vezi [`/languages/`](/languages/)). Trimite `lang=<cod>` la orice punct de capăt `/v1/reports/*`.

## Prețuri

Majoritatea punctelor de capăt vedice sunt **Tier 2 (20 de credite)**. Rapoartele mari (compatibilitate completă, scaner muhūrta) — Tier 3 (50 de credite). Rapoartele PDF Lal Kitab / Vedic Kundli — Tier 7 (5000 de credite).

Pe planul **Free** — **500 de apeluri vedice pe lună gratuit**.

<CardGrid>
  <LinkCard title="Categorii de puncte de capăt →" href="/vedic/" description="Daśa, Varga, Pañcāṅga, Ṣaḍbala, Yoga, Doṣa, Compatibilitate, Muḥūrta" />
  <LinkCard title="Primii pași" href="/getting-started/" description="Primul apel în 5 minute" />
  <LinkCard title="Prețuri" href="/pricing/" description="De la gratuit la Enterprise" />
  <LinkCard title="Suport limbă" href="/languages/" description="21 de limbi — rapoarte vedice" />
</CardGrid>