# Védikus API

Az AstroWay API **354+ jyotish-astrológiai endpointot** kínál — ez a legátfogóbb lefedettség a Jyotish területén a kereskedelmi API-k között. A klasszikus BṚHAT PARĀŚARA HORĀ ŚĀSTRA, a teljes Lal Kitab, a KP-módszer és a Jaimini-szútrák mind keresztellenőrzésre kerültek a PyJHora nevű referenciaimplementációval.

## Mi számítható ki

| Kategória | Lefedettség |
|---|---|
| **Dasa-k** | 10 rendszer (Vimśottari + 9 alternatív) × 5 szint = **50 endpoint** |
| **Varga-k** | A Shodasha varga D1–D60 egyetlen hívással |
| **Pancsaṅga** | Tithi, Karana, Yoga-nap, Nakṣatra-nap, Cogadia, Hora, Rāhu-kāla, teljes |
| **Śadbala** | 6-szoros erő: Sthāna + Dig + Kala + Cesta + Naisargika + Dṛk + teljes |
| **Jóga-k** | Parāśara (Rāja, Dāna, Dharma-Karmādipati, Pañca-Mahāpuruṣa, Gaja-Kesarī, Adhi) + Jaimini (karaka-yoga, karakāṃśa, śubha-graha) |
| **Dosa-k** | Parāśara (Māṅgala, Kāla-Sarpa, Pitṛ, Śrapit, Grahaṇa, Guru-Caṇḍāla) + Lal Kitab Maṅglika + KP |
| **Összeillőség** | Aṣṭakūṭa (8-szoros Guna-Milana), Daśakoṭa, Maṅglika-check, Maṅgala-mec, Bhṛgu-mec |
| **Muhūrta** | Elektív — esküvő, autó, üzlet, utazás, névadás, műtét, oktatás, befektetés, ingatlan, gṛha-praveśa, eljegyzés, bírósági eljárás |
| **Lal Kitab** | Teljes csomag: csillagkép, bolygók, rishik, tattvák, varga-k, upāya |
| **KP** | Krishnamurti Paddhati a ruling planets, sub-lord theory, KP jóga-k/dosa-k |
| **Jaimini** | Karakák, Cāra-karakák, Pādák, Upapādák, Aspektusok, Dṛṣṭi, Ātmakaraka-Navamśa, Daha-összefoglaló, Jóga-k + extrák: karaka-yoga, karakāṃśa, atmakaraka-rotation, argala-analízis |

## Példa: Vimśottari-dasa

<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(`Current MD: ${data.current.lord} until ${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>

## Egyedi lehetőségek

Olyan endpointok, amelyek a versenytársaknál nem találhatók:

- **10 dasa-rendszer**, beleértve a ritka Tribhagi, Śatābdika, Śodaśottari, Sthira, Śūla rendszereket (a legtöbb API csak a Vimśottarit kínálja)
- **Karakāṃśa mint 12-es házas csillagkép** — teljes vetítés az iṣṭa-devatával és mokṣa-értékekkel
- **Argala-analízis** — teljes Argalá + Virodhārgala szkennelése a 12 ház mentén a netInfluence-mérőszámmal
- **Ātmakaraka-rotation** — progresszív ĀK az élet során life-event triggerrel
- **Keresztiskolai dosa-k** — Parāśara + Lal Kitab + KP egyetlen API-n (a legtöbb csak egy iskolát kínál)

## Ki használja

- **Indiai asztrológiai alkalmazások** (Pratyangira, Drik Panchang, AstroSage stb.) — teljes backend a saját efemerida nélkül
- **Házasság-összeillőségi szolgáltatások** — Aṣṭakūṭa + Daśakoṭa + Maṅglika egyetlen hívással
- **Mobil horoszkópalkalmazások** — napi Pancsaṅga a `/v1/vedic/panchang/full` endpointon keresztül (8 elem egyetlen lekérdezéssel)
- **Elektív szolgáltatások** (gyerek névadása, esküvői muhūrta) — `/v1/vedic/muhurat/*` 12 eseménytípus
- **Vedic összeillőségi szolgáltatások** — teljes jelentés a `/v1/vedic/compatibility/full` endpointon keresztül

## Pontosság

Minden számítás a **Swiss Ephemeris** (szubívmás pontosság) alapján történik, és keresztellenőrzésre kerül a **PyJHora** (de-facto referenciaimplementáció Pythonban) ellen. Ahol eltérés van, azt a `docs/AUDIT-TRAIL.md` dokumentumban rögzítettük.

A különböző hagyományokat követő iskolák (Lal Kitab, KP, Jaimini) külön **SÁRGA** jelölést kapnak azokon az endpointokon, ahol single-author módszer van (Lal Kitab — csak Pt. Roop Chand Joshi). Az integrátor látja a kanonikusitási szintet.

## Lokalizáció

A Vedic-jelentések **20 nyelven** elérhetők (T0 manuális, T1 AI Beta — lásd [`/languages/`](/languages/)). Add hozzá a `lang=<code>` paramétert bármely `/v1/reports/*` endpointhoz.

## Árak

A legtöbb Vedic-endpoint **Tier 2 (20 credit)**. A nagyobb jelentések (teljes összeillőség, muhūrta-szkennelő) **Tier 3 (50 credit)**. A PDF-jelentések (Lal Kitab / Vedic Kundli) **Tier 7 (5000 credit)**.

A Free tarifán **500 Vedic-hívás ingyenes havonta**.

<CardGrid>
  <LinkCard title="Endpoint-kategóriák →" href="/vedic/" description="Dasa-k, Varga-k, Pancsaṅga, Śadbala, Jóga-k, Dosa-k, Összeillőség, Muhūrta" />
  <LinkCard title="Gyors kezdés" href="/getting-started/" description="Első lekérdezés 5 perc alatt" />
  <LinkCard title="Árak" href="/pricing/" description="Ingyenestől az Enterprise-ig" />
  <LinkCard title="Nyelvi támogatás" href="/languages/" description="20 nyelv — Vedic-jelentések" />
</CardGrid>