# API Veda

AstroWay API memiliki **354+ endpoint astrologi Vedic** — cakupan terlengkap Jyotish di antara API komersial. Klasik BPHS-Parashara, Lal Kitab lengkap, metode KP, Jaimini Sutras — semuanya telah diverifikasi silang terhadap PyJHora.

## Apa yang Dihitung

| Kategori | Cakupan |
|---|---|
| **Dasas** | 10 sistem (Vimshottari + 9 alternatif) × 5 level = **50 endpoint** |
| **Vargas** | Shodasha varga D1–D60 dalam satu panggilan |
| **Panchang** | Tithi, Karana, Yoga hari, Nakshatra hari, Chogadia, Hora, Rahu Kaal, lengkap |
| **Shadbala** | Kekuatan 6 kali lipat: Sthana + Dig + Kala + Cheshta + Naisargika + Drik + lengkap |
| **Yogas** | Parashara (Raja, Dana, Dharma-Karmadipati, Pancha-Mahapurusha, Gajakesari, Adhi) + Jaimini (karaka-yoga, karakamsa, shubha-graha) |
| **Doshas** | Parashara (Mangal, Kalasarpa, Pitru, Shrapit, Grahan, Guru-Chandal) + Lal Kitab Manglik + KP |
| **Kecocokan** | Ashtakoota (8 kali Guna-Milan), Dashakoota, Manglik-check, Mangal-mesh, Brihu-mesh |
| **Muhurta** | Elektif — pernikahan, mobil, bisnis, perjalanan, pertunangan, operasi, pendidikan, investasi, properti, griha-pravesh, pertunangan, proses hukum |
| **Lal Kitab** | Paket lengkap: chart, grahas, rishis, tattvas, Vargas, upayas |
| **KP** | Krishnamurti Paddhati dengan ruling planets, teori sub-lord, KP yogas/doshas |
| **Jaimini** | Karakas, Chara-karakas, Padas, Upapadas, Aspek, Drishti, Atmakaraka-Navamsa, Daha-summary, Yogas + extras: karaka-yoga, karakamsa, atmakaraka-rotation, argala-analysis |

## Contoh: Dasa Vimshottari

<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 Saat Ini: ${data.current.lord} hingga ${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 Saat Ini: {data['current']['lord']} hingga {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 Saat Ini: {$data['current']['lord']} hingga {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Fitur Unik

Endpoint yang tidak dimiliki kompetitor:

- **10 sistem dasa** termasuk yang langka seperti Tribhagi, Shatabdika, Shodashottari, Sthira, Shoola (sebagian besar API hanya memiliki Vimshottari)
- **Karakamsa sebagai chart 12 rumah** — proyeksi lengkap dengan ishta-devata + nilai moksha
- **Argala-analysis** — pemindaian lengkap Argala + Virodhargala di 12 rumah dengan metrik netInfluence
- **Atmakaraka-rotation** — progresi AK melalui kehidupan dengan pencetus peristiwa hidup
- **Cross-school doshas** — Parashara + Lal Kitab + KP dalam satu API (sebagian besar hanya menyediakan satu sekolah)

## Siapa yang Menggunakan

- **Aplikasi astrologi India** (seperti Pratyangira, Drik Panchang, AstroSage) — backend lengkap tanpa perlu efemeris sendiri
- **Pencocokan pernikahan** — Ashtakoota + Dashakoota + Manglik dalam satu panggilan
- **Aplikasi horoskop mobile** — Panchang harian melalui `/v1/vedic/panchang/full` (8 elemen dalam 1 permintaan)
- **Layanan elektif** (pertunangan anak, muhurta pernikahan) — `/v1/vedic/muhurat/*` untuk 12 jenis acara
- **Layanan kecocokan Vedic** — laporan lengkap melalui `/v1/vedic/compatibility/full`

## Akurasi

Semua perhitungan didasarkan pada **Swiss Ephemeris** (presisi sub-arcsecond) + diverifikasi silang terhadap **PyJHora** (implementasi referensi de-facto di Python). Perbedaan yang ada didokumentasikan dalam `docs/AUDIT-TRAIL.md`.

Sekolah dengan tradisi berbeda (Lal Kitab, KP, Jaimini) memiliki penanda KUNING khusus untuk endpoint yang menggunakan metode single-author (Lal Kitab — hanya Pt. Roop Chand Joshi) — integrator dapat melihat tingkat kanonisitasnya.

## Lokalisasi

Laporan Vedic tersedia dalam **20 bahasa** (T0 manual, T1 AI Beta — lihat [`/languages/`](/languages/)). Kirimkan `lang=<code>` ke endpoint `/v1/reports/*` mana pun.

## Harga

Sebagian besar endpoint Vedic adalah **Tier 2 (20 kredit)**. Laporan besar (kecocokan lengkap, pemindai muhurta) — Tier 3 (50 kredit). Laporan PDF Lal Kitab / Vedic Kundli — Tier 7 (5000 kredit).

Pada paket Free — **500 panggilan Vedic per bulan gratis**.

<CardGrid>
  <LinkCard title="Kategori Endpoint →" href="/vedic/" description="Dasas, Vargas, Panchang, Shadbala, Yogas, Doshas, Kecocokan, Muhurta" />
  <LinkCard title="Mulai Cepat" href="/getting-started/" description="Permintaan pertama dalam 5 menit" />
  <LinkCard title="Harga" href="/pricing/" description="Dari gratis hingga Enterprise" />
  <LinkCard title="Dukungan Bahasa" href="/languages/" description="20 bahasa — Laporan Vedic" />
</CardGrid>