# API Vedic

AstroWay API má **354+ koncových bodů védské astrologie** — nejrozsáhlejší pokrytí Jyotish mezi komerčními API. Klasický Bṛhat Parāśara Horā Śāstra, úplný Lal Kitab, KP metoda, Jaimini sútry — vše je křížově ověřeno proti PyJHora.

## Co se počítá

| Kategorie | Pokrytí |
|---|---|
| **Daše** | 10 systémů (Vimśottarī + 9 alternativ) × 5 úrovní = **50 koncových bodů** |
| **Varga** | Šodašavarga D1–D60 v jednom volání |
| **Paňčang** | Tithi, Karana, Jóga-dne, Nakšatra-dne, Čogadía, Hora, Ráhu-kál, úplné |
| **Šadbala** | 6-násobná síla: Sthána + Dig + Kala + Češta + Naisargika + Drik + úplné |
| **Jógy** | Parāśara (Rádža, Dána, Dharma-Karmādipatí, Paňča-Mahápuruša, Gadžakesarí, Adhí) + Jaimini (karaka-jóga, karakáṃsa, śubha-graha) |
| **Doše** | Parāśara (Mangala, Kálasárpa, Pitṛu, Śrapit, Grahaṇa, Guru-Čaṇḍala) + Lal Kitab Manglik + KP |
| **Kompatibilita** | Aštakúta (8-násobný Guna-Mílan), Dašakóta, Manglik-ček, Mangal-mech, Bhṛgu-mech |
| **Muhúrta** | Elektivní — svatba, auto, podnikání, cesta, zasnoubení, operace, vzdělání, investice, nemovitosti, gṛha-praveśa, zasnoubení, soudní proces |
| **Lal Kitab** | Úplný balíček: chart, grahy, riši, tatvas, varga, upája |
| **KP** | Krishnamurti Paddhati s ruling planets, sub-lord theory, KP jógy/doše |
| **Jaimini** | Karakas, Čára-karakas, Padas, Upapadas, Aspekty, Dṛšti, Ātmakaraka-Navamša, Daha-summary, Jógy + extras: karaka-jóga, karakáṃsa, atmakaraka-rotation, argala-analysis |

## Příklad: Vimśottarī-daša

<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(`Současná MD: ${data.current.lord} do ${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"Současná MD: {data['current']['lord']} do {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 "Současná MD: {$data['current']['lord']} do {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Unikátní možnosti

Koncové body, které nemají konkurence:

- **10 systémů daš** včetně vzácných Tribhagi, Šatabdika, Šodašottarí, Sthira, Šúla (většina API má pouze Vimśottarī)
- **Karakáṃsa jako 12-house chart** — úplná projekce s iṣṭa-devatá + mokša-hodnotami
- **Argala-analysis** — úplný scan Argala + Virodhargala ve 12 domech s metrikou netInfluence
- **Ātmakaraka-rotation** — progresivní ÁK napříč životem s life-event triggers
- **Cross-school doše** — Parāśara + Lal Kitab + KP v jednom API (většina poskytuje pouze jednu školu)

## Kdo používá

- **Indické astrologické aplikace** (Pratyangira, Drik Paňčang, AstroSage a další) — úplný backend bez nutnosti vlastní efemeridy
- **Svatby a seznámení** — Aštakúta + Dašakóta + Manglik v jednom volání
- **Mobilní horoskopové aplikace** — denní Paňčang přes `/v1/vedic/panchang/full` (8 prvků v 1 dotazu)
- **Elektivní služby** (zasvěcení dítěte, muhúrta svatby) — `/v1/vedic/muhurat/*` 12 druhů událostí
- **Védské kompatibility** — úplná zpráva přes `/v1/vedic/compatibility/full`

## Přesnost

Veškeré výpočty jsou založeny na **Swiss Ephemeris** (sub-arcsecond přesnost) + křížově ověřeno proti **PyJHora** (de-facto referenční implementace v Pythonu). Odchylky, kde se vyskytují, jsou zdokumentovány v `docs/AUDIT-TRAIL.md`.

Školy z různých tradic (Lal Kitab, KP, Jaimini) mají samostatné **ŽLUTÉ** označení pro koncové body s metodou jediného autora (Lal Kitab — pouze Pt. Roop Chand Joshi) — integrátor vidí úroveň kanonické správnosti.

## Lokalizace

Védské zprávy jsou dostupné v **20 jazycích** (T0 manuálně, T1 AI Beta — viz [`/languages/`](/languages/)). Předejte `lang=<code>` do libovolného `/v1/reports/*` koncového bodu.

## Ceník

Většina védských koncových bodů je **Tier 2 (20 kreditů)**. Velké zprávy (úplná kompatibilita, muhúrta-skener) jsou Tier 3 (50 kreditů). PDF zprávy Lal Kitab / Védský Kundlí jsou Tier 7 (5000 kreditů).

Na Free tarifu máš **500 védských volání měsíčně zdarma**.

<CardGrid>
  <LinkCard title="Kategorie koncových bodů →" href="/vedic/" description="Daše, Varga, Paňčang, Šadbala, Jógy, Doše, Kompatibilita, Muhúrta" />
  <LinkCard title="Rychlý start" href="/getting-started/" description="První dotaz během 5 minut" />
  <LinkCard title="Ceník" href="/pricing/" description="Od zdarma po Enterprise" />
  <LinkCard title="Podpora jazyků" href="/languages/" description="20 jazyků — védské zprávy" />
</CardGrid>
