# API Vedic

AstroWay API oferuje **354+ punktów końcowych astrologii wedyjskiej** — najszersze pokrycie Jyotish wśród komercyjnych API. Klasyczny system Bṛhat Parāśara Horā Śāstra (BPHS), pełny Lal Kitab, metodyka KP, Jaimini Sutry — wszystkie obliczenia zostały skrzyżowane i zweryfikowane względem PyJHora.

## Co jest obliczane

| Kategoria | Pokrycie |
|---|---|
| **Daśa** | 10 systemów (Vimśottari + 9 alternatywnych) × 5 poziomów = **50 punktów końcowych** |
| **Varga** | Shodasha varga D1–D60 w jednym zapytaniu |
| **Pañcaṅga** | Tiṭhī, Karaṇa, Yoga-dnia, Nakṣatra-dnia, Cogadia, Hora, Rāhu-kāla, pełny |
| **Śadbalā** | 6-krotna siła: Sthāna + Dig + Kāla + Ceṣṭa + Naisargika + Dṛk + pełna |
| **Yoga** | Paraśara (Rāja, Dāna, Dharma-Karmādhipati, Pañca-Mahāpuruṣa, Gajakeśarī, Adhi) + Jaimini (karaka-yoga, karakāṃśa, śubha-graha) |
| **Dośa** | Paraśara (Māṅgala, Kāla-Sarpa, Pitṛ, Śrapit, Grahaṇa, Guru-Cāṇḍāla) + Lal Kitab Māṅgalika + KP |
| **Zgodność** | Aṣṭakoṭa (8-krotny Gun-Milan), Daśakoṭa, Māṅgalika-check, Maṅgala-mec, Bhṛgu-mec |
| **Muhūrta** | Elektoralna — ślub, samochód, biznes, podróż, inwestycje, nieruchomości, wejście do domu, zaręczyny, proces sądowy |
| **Lal Kitab** | Pełny pakiet: chart, grahy, ṛṣi, tatwy, varga, upāya |
| **KP** | Krishnamurti Paddhati z ruling planets, teoria sub-lord, KP yogas/doshas |
| **Jaimini** | Karaki, Chara-karaki, Pada, Upapada, aspekty, dṛṣṭi, Ātmākaraka-Navamśa, Daha-summary, Yogas + dodatki: karaka-yoga, karakāṃśa, atmākaraka-rotation, argala-analysis |

## Przykład: Wimśottari 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(`Aktualny 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"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>

## Unikalne możliwości

Punkty końcowe, których nie znajdziesz u konkurencji:

- **10 systemów daś** łącznie z rzadkimi Tribhagi, Śatābdika, Śodśottari, Sthira, Śūla (większość API oferuje tylko Vimśottari)
- **Karakāṃśa jako chart 12-domowy** — pełna projekcja z iṣṭa-devatā + wartościami mokszy
- **Argala-analysis** — pełny skan Argali + Virodhargali w 12 domach z metryką netInfluence
- **Ātmākaraka-rotation** — progresywny ĀK przez całe życie z triggerami wydarzeń życiowych
- **Cross-school doś** — Paraśara + Lal Kitab + KP w jednym API (większość oferuje tylko jedną szkołę)

## Kto używa

- **Aplikacje astrologii indyjskiej** (odpowiedniki Pratyangiry, Drik Panchang, AstroSage) — pełny backend bez konieczności posiadania własnej efemerydy
- **Usługi dobierania partnerów małżeńskich** — Aṣṭakoṭa + Daśakoṭa + Māṅgalika w jednym zapytaniu
- **Aplikacje horoskopów mobilnych** — codzienny Pañcaṅga przez `/v1/vedic/panchang/full` (8 elementów w jednym zapytaniu)
- **Usługi electional** (wybór czasu na narodziny dziecka, muhūrta na ślub) — `/v1/vedic/muhurat/*` 12 rodzajów wydarzeń
- **Usługi zgodności wedyjskiej** — pełny raport przez `/v1/vedic/compatibility/full`

## Dokładność

Wszystkie obliczenia opierają się na **Swiss Ephemeris** (precyzja poniżej sekundy łuku) + skrzyżowane i zweryfikowane względem **PyJHora** (de facto referencyjna implementacja w Pythonie). Różnice, gdzie występują, są udokumentowane w `docs/AUDIT-TRAIL.md`.

Szkoły z różnymi tradycjami (Lal Kitab, KP, Jaimini) mają osobne **żółte oznaczenia** dla punktów końcowych, gdzie metoda jest autorstwa pojedynczego autora (Lal Kitab — tylko Pt. Roop Chand Joshi) — integrator widzi poziom kanoniczności.

## Lokalizacja

Raporty wedyjskie dostępne są w **21 językach** (T0 — ręcznie, T1 AI Beta — zobacz [`/languages/`](/languages/)). Przekaż parametr `lang=<code>` do dowolnego punktu końcowego `/v1/reports/*`.

## Cennik

Większość punktów wedyjskich to **Tier 2 (20 kredytów)**. Duże raporty (pełna zgodność, skaner muhūrta) to Tier 3 (50 kr.). Raporty PDF Lal Kitab / Vedic Kundli to Tier 7 (5000 kr.).

Na darmowym planie masz **500 darmowych zapytań wedyjskich miesięcznie**.

<CardGrid>
  <LinkCard title="Kategorie punktów końcowych →" href="/vedic/" description="Daśa, Varga, Pañcaṅga, Śadbalā, Yoga, Dośa, Zgodność, Muhūrta" />
  <LinkCard title="Szybki start" href="/getting-started/" description="Pierwsze zapytanie w 5 minut" />
  <LinkCard title="Cennik" href="/pricing/" description="Od darmowego do Enterprise" />
  <LinkCard title="Wsparcie językowe" href="/languages/" description="21 języków — raporty wedyjskie" />
</CardGrid>