# API Vedic

AstroWay API cung cấp **hơn 354+ endpoints về chiêm tinh học Vệ Đà** — đây là bộ sưu tập đầy đủ nhất về Jyotish giữa các API thương mại. Phương pháp cổ điển BPHS-Parashara, toàn bộ Lal Kitab, hệ thống KP, Jaimini Sutras — tất cả đều được kiểm tra chéo với PyJHora.

## Những gì được tính toán

| Danh mục | Độ phủ |
|---|---|
| **Dasha** | 10 hệ thống (Vimshottari + 9 hệ thống thay thế) × 5 cấp độ = **50 endpoints** |
| **Varga** | Shodasha varga D1–D60 trong một lần gọi |
| **Panchang** | Tithi, Karana, Yoga theo ngày, Nakshatra theo ngày, Chogadia, Hora, Rahu Kaal, đầy đủ |
| **Shadbala** | Sức mạnh 6 phần: Sthana + Dig + Kala + Cheshta + Naisargika + Drik + đầy đủ |
| **Yoga** | Parashara (Raja, Dana, Dharma-Karmadipati, Pancha-Mahapurusha, Gajakesari, Adhi) + Jaimini (karaka-yoga, karakamsa, shubha-graha) |
| **Dosha** | Parashara (Mangal, Kalasarpa, Pitru, Shrapit, Grahan, Guru-Chandal) + Lal Kitab Manglik + KP |
| **Tương thích** | Ashtakoota (Gun-Milan 8 phần), Dashakoota, Manglik-check, Mangal-mesh, Bhrigu-mesh |
| **Muhurta** | Điện tướng — đám cưới, ô tô, kinh doanh, du lịch, đặt tên, phẫu thuật, giáo dục, đầu tư, bất động sản, Griha Pravesh, đính hôn, tố tụng |
| **Lal Kitab** | Gói đầy đủ: biểu đồ, grahas, rishi, tattvas, vargas, upaya |
| **KP** | Krishnamurti Paddhati với hành tinh chi phối, lý thuyết sub-lord, KP yogas/doshas |
| **Jaimini** | Karakas, Chara Karakas, Padas, Upapada, khía cạnh, Drishti, Atmakaraka-Navamsa, Daha-summary, Yogas + extras: karaka-yoga, karakamsa, atmakaraka-rotation, argala-analysis |

## Ví dụ: Vimshottari Dasha

<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 hiện tại: ${data.current.lord} đến ${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 hiện tại: {data['current']['lord']} đến {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 hiện tại: {$data['current']['lord']} đến {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Tính năng độc quyền

Những endpoints mà đối thủ không có:

- **10 hệ thống Dasha** bao gồm cả những hệ thống hiếm như Tribhagi, Shatabdika, Shodashottari, Sthira, Shoola (hầu hết API chỉ có Vimshottari)
- **Karakamsa như biểu đồ nhà thứ 12** — hình chiếu đầy đủ với ishta-devata + giá trị moksha
- **Phân tích Argala** — quét toàn bộ Argala + Virodhargala theo 12 nhà với chỉ số netInfluence
- **Atmakaraka-rotation** — tiến triển AK xuyên suốt cuộc đời với các sự kiện triggers
- **Cross-school doshas** — Parashara + Lal Kitab + KP trong cùng một API (hầu hết chỉ cung cấp một trường phái)

## Ai đang sử dụng

- **Ứng dụng chiêm tinh học Ấn Độ** (tương tự Pratyangira, Drik Panchang, AstroSage) — backend đầy đủ mà không cần sử dụng ephemeris riêng
- **Dịch vụ mai mối hôn nhân** — Ashtakoota + Dashakoota + Manglik trong một lần gọi
- **Ứng dụng tử vi di động** — Panchang hàng ngày qua `/v1/vedic/panchang/full` (8 yếu tố trong 1 yêu cầu)
- **Dịch vụ điện tướng** (đặt tên trẻ em, giờ tốt cho đám cưới) — `/v1/vedic/muhurat/*` với 12 loại sự kiện
- **Dịch vụ tương thích Vệ Đà** — báo cáo đầy đủ qua `/v1/vedic/compatibility/full`

## Độ chính xác

Mọi phép tính đều dựa trên **Swiss Ephemeris** (độ chính xác dưới giây cung) + kiểm tra chéo với **PyJHora** (triển khai tham chiếu de-facto bằng Python). Những khác biệt (nếu có) đều được ghi chép trong `docs/AUDIT-TRAIL.md`.

Các trường phái với truyền thống khác nhau (Lal Kitab, KP, Jaimini) có các biểu tượng **MÀU VÀNG** cho endpoints sử dụng phương pháp single-author (Lal Kitab — chỉ Pt. Roop Chand Joshi) — nhà tích hợp có thể thấy mức độ chính thống.

## Bản địa hóa

Báo cáo Vệ Đà có sẵn bằng **20 ngôn ngữ** (T0 thủ công, T1 AI Beta — xem [`/languages/`](/languages/)). Truyền tham số `lang=<code>` vào bất kỳ endpoint `/v1/reports/*` nào.

## Bảng giá

Hầu hết endpoints Vệ Đà là **Tier 2 (20 tín dụng)**. Những báo cáo lớn (tương thích đầy đủ, máy quét Muhurta) là Tier 3 (50 tín dụng). Báo cáo PDF của Lal Kitab / Vedic Kundli là Tier 7 (5000 tín dụng).

Ở gói Free, bạn có **500 lượt gọi Vệ Đà miễn phí mỗi tháng**.

<CardGrid>
  <LinkCard title="Danh mục endpoints →" href="/vedic/" description="Dasha, Varga, Panchang, Shadbala, Yoga, Dosha, Tương thích, Muhurta" />
  <LinkCard title="Bắt đầu nhanh" href="/getting-started/" description="Làm quen trong 5 phút" />
  <LinkCard title="Bảng giá" href="/pricing/" description="Từ miễn phí đến doanh nghiệp" />
  <LinkCard title="Hỗ trợ ngôn ngữ" href="/languages/" description="20 ngôn ngữ — báo cáo Vệ Đà" />
</CardGrid>