# API Vedic

AstroWay API має **354+ ендпоінтів ведичної астрології** — найповніше покриття Jyotish серед комерційних API. Класичний БПХС-Параshara, повний Лал Кітаб, КП-методика, Джайміні-сутри — все перехресно перевірено проти PyJHora.

## Що розраховується

| Категорія | Покриття |
|---|---|
| **Даши** | 10 систем (Vimshottari + 9 альтернатив) × 5 рівнів = **50 ендпоінтів** |
| **Варги** | Shodasha varga D1–D60 в одному виклику |
| **Панчанг** | Тітхі, Карана, Йога-дня, Накшатра-дня, Чогадія, Хора, Раху-каал, повний |
| **Шадбала** | 6-кратна сила: Стхана + Діг + Кала + Чешта + Найсаргіка + Дрик + повна |
| **Йоги** | Параshara (Раджа, Дана, Дхарма-Кармадіпаті, Pancha-Mahapurusha, Гаджакесарі, Адхі) + Jaimini (karaka-yoga, karakamsa, shubha-graha) |
| **Доші** | Параshara (Мангаль, Каал-Сарп, Пітру, Шрапіт, Грахан, Гуру-Чандал) + Лал Кітаб Манглик + КП |
| **Сумісність** | Аштакут (8-кратна Гун-Мілан), Дашакоота, Манглик-чек, Мангал-меч, Бхрігу-меч |
| **Мухурта** | Електорал — весілля, авто, бізнес, подорож, наречення, операція, освіта, інвестиції, нерухомість, гриха-правеш, заручини, судовий процес |
| **Лал Кітаб** | Повний пакет: чарт, грахи, ріши, татвас, варгас, упайя |
| **КП** | Krishnamurti Paddhati з ruling planets, sub-lord theory, KP yogas/doshas |
| **Джайміні** | Караки, Чара-караки, Падас, Упапада, Аспекти, Дришти, Атмакарака-Навамша, Daha-summary, Йоги + extras: karaka-yoga, karakamsa, atmakaraka-rotation, argala-analysis |

## Приклад: Вімшоттарі-даша

<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: ${data.current.lord} до ${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>

## Унікальні можливості

Ендпоінти, яких немає у конкурентів:

- **10 систем дешів** включно з рідкісними Tribhagi, Shatabdika, Shodashottari, Sthira, Shoola (більшість API мають тільки Vimshottari)
- **Karakamsa як 12-house chart** — повна проекція з ішта-девата + мокша-значеннями
- **Argala-analysis** — повний скан Аргала + Віродхаргала по 12 будинках з netInfluence-метрикою
- **Atmakaraka-rotation** — прогресивний АК через життя з life-event triggers
- **Cross-school doshas** — Парашара + Лал Кітаб + КП в одному API (більшість дають тільки одну школу)

## Хто використовує

- **Indian astrology apps** (Pratyangira, Drik Panchang, AstroSage аналоги) — повний бекенд без необхідності власної ефемериди
- **Marriage matchmaking** — Аштакут + Дашакоота + Манглик в одному виклику
- **Mobile horoscope apps** — щоденний Панчанг через `/v1/vedic/panchang/full` (8 елементів за 1 запит)
- **Electional услуги** (наречення дитини, мухурта весілля) — `/v1/vedic/muhurat/*` 12 видів подій
- **Vedic compatibility services** — full report через `/v1/vedic/compatibility/full`

## Точність

Усі обчислення спираються на **Swiss Ephemeris** (sub-arcsecond precision) + cross-checked проти **PyJHora** (de-facto reference імплементація на Python). Розбіжності, де є, документовані в `docs/AUDIT-TRAIL.md`.

Школи з різними традиціями (Лал Кітаб, КП, Джайміні) мають окремі YELLOW позначки для ендпоінтів де single-author method (Lal Kitab — Pt. Roop Chand Joshi only) — інтегратор бачить рівень канонічності.

## Локалізація

Vedic-репорти доступні **20 мовами** (T0 манульно, T1 AI Beta — див. [`/languages/`](/languages/)). Передавайте `lang=<code>` у будь-який `/v1/reports/*` ендпоінт.

## Вартість

Більшість Vedic-ендпоінтів — **Tier 2 (20 кредитів)**. Великі звіти (повна сумісність, мухурта-сканер) — Tier 3 (50 кр). PDF-репорти Lal Kitab / Vedic Kundli — Tier 7 (5000 кр).

На Free тарифі — **500 Vedic-викликів на місяць безкоштовно**.

<CardGrid>
  <LinkCard title="Категорії ендпоінтів →" href="/vedic/" description="Даши, Варги, Панчанг, Шадбала, Йоги, Доші, Сумісність, Мухурта" />
  <LinkCard title="Швидкий старт" href="/getting-started/" description="Перший запит за 5 хвилин" />
  <LinkCard title="Тарифи" href="/pricing/" description="Від безкоштовного до Enterprise" />
  <LinkCard title="Підтримка мов" href="/languages/" description="20 мов — Vedic-репорти" />
</CardGrid>