# API Vedic

AstroWay API heeft **354+ endpoints voor Vedische astrologie** — de meest complete dekking van Jyotish onder commerciële API's. Klassieke Bṛhat Parāśara Horā Śāstra, volledige Lal Kitab, KP-methode, Jaimini Sūtra's — alles is kruislings geverifieerd tegen PyJHora.

## Wat wordt berekend

| Categorie | Dekking |
|---|---|
| **Dashas** | 10 systemen (Vimshottari + 9 alternatieven) × 5 niveaus = **50 endpoints** |
| **Vargas** | Shodasha varga D1–D60 in één oproep |
| **Panchang** | Tithi, Karana, Yoga-dag, Nakshatra-dag, Chogadia, Hora, Rahu-kaal, volledig |
| **Shadbala** | 6-voudige kracht: Sthana + Dig + Kala + Cheshta + Naisargika + Drik + volledig |
| **Yogas** | Parāśara (Rāja, Dāna, Dharma-Karmādipati, Pancha-Mahapurusha, Gajakesari, Adhi) + Jaimini (karaka-yoga, karakamsa, shubha-graha) |
| **Doshas** | Parāśara (Mangal, Kala-Sarpa, Pitru, Shrapit, Grahan, Guru-Chandal) + Lal Kitab Manglik + KP |
| **Compatibiliteit** | Ashtakoot (8-voudige Guna-Milan), Dashakoota, Manglik-check, Mangal-mesh, Brihu-mesh |
| **Muhurta** | Electieve — huwelijk, auto, zaken, reis, verloving, operatie, onderwijs, investeringen, onroerend goed, griha-pravesh, verloving, juridisch proces |
| **Lal Kitab** | Volledig pakket: chart, grahas, rishis, tattvas, Vargas, upayas |
| **KP** | Krishnamurti Paddhati met ruling planets, sub-lord theory, KP yogas/doshas |
| **Jaimini** | Karakas, Chara-karakas, Padas, Upapadas, Aspecten, Drishti, Atmakaraka-Navamsha, Daha-summary, Yogas + extras: karaka-yoga, karakamsa, atmakaraka-rotation, argala-analysis |

## Voorbeeld: Vimshottari Dasha

<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(`Huidige MD: ${data.current.lord} tot ${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"Current MD: {data['current']['lord']} until {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 "Current MD: {$data['current']['lord']} until {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Unieke mogelijkheden

Endpoints die concurrenten niet bieden:

- **10 dasha-systemen** inclusief zeldzame Tribhagi, Shatabdika, Shodashottari, Sthira, Shoola (de meeste API's hebben alleen Vimshottari)
- **Karakamsa als 12-huizen chart** — volledige projectie met ishta-devata + moksha-waarden
- **Argala-analysis** — volledige scan van Argala + Virodhargala over 12 huizen met netInfluence-metric
- **Atmakaraka-rotation** — progressieve AK door het leven met life-event triggers
- **Cross-school doshas** — Parāśara + Lal Kitab + KP in één API (de meeste geven alleen één school)

## Wie gebruikt AstroWay

- **Indiase astrologie-apps** (Pratyangira, Drik Panchang, AstroSage-achtigen) — volledige backend zonder eigen efemeriden
- **Huwelijksmatchmaking** — Ashtakoot + Dashakoota + Manglik in één oproep
- **Mobiele horoscoop-apps** — dagelijkse Panchang via `/v1/vedic/panchang/full` (8 elementen in 1 request)
- **Electieve diensten** (kindernaming, muhurta voor huwelijk) — `/v1/vedic/muhurat/*` 12 soorten gebeurtenissen
- **Vedische compatibiliteitsdiensten** — volledige rapportage via `/v1/vedic/compatibility/full`

## Nauwkeurigheid

Alle berekeningen zijn gebaseerd op **Swiss Ephemeris** (sub-boogseconde precisie) + kruisgecontroleerd tegen **PyJHora** (de facto referentie-implementatie in Python). Verschillen, waar die zijn, zijn gedocumenteerd in `docs/AUDIT-TRAIL.md`.

Scholen met verschillende tradities (Lal Kitab, KP, Jaimini) hebben aparte **GELE** markeringen voor endpoints waar een single-author methode wordt gebruikt (Lal Kitab — alleen Pt. Roop Chand Joshi) — de integrator ziet het niveau van canoniciteit.

## Lokalisatie

Vedische rapporten zijn beschikbaar in **20 talen** (T0 handmatig, T1 AI Beta — zie [`/languages/`](/languages/)). Geef `lang=<code>` mee in elke `/v1/reports/*` endpoint.

## Prijs

De meeste Vedic-endpoints zijn **Tier 2 (20 credits)**. Grote rapporten (volledige compatibiliteit, muhurta-scanner) zijn Tier 3 (50 credits). PDF-rapporten Lal Kitab / Vedic Kundli zijn Tier 7 (5000 credits).

Op het Free-tarief krijg je **500 Vedic-oproepen per maand gratis**.

<CardGrid>
  <LinkCard title="Endpointcategorieën →" href="/vedic/" description="Dashas, Vargas, Panchang, Shadbala, Yogas, Doshas, Compatibiliteit, Muhurta" />
  <LinkCard title="Snel starten" href="/getting-started/" description="Eerste request in 5 minuten" />
  <LinkCard title="Tariefplannen" href="/pricing/" description="Van gratis tot Enterprise" />
  <LinkCard title="Taalondersteuning" href="/languages/" description="20 talen — Vedische rapporten" />
</CardGrid>