# 베딕 API

AstroWay API는 **354+개의 베다 점성술 엔드포인트**를 제공합니다 — 상업용 API 중 가장 포괄적인 **Jyotish** 커버리지입니다. 고전적인 BPHS-Parashara, 완전한 Lal Kitab, KP 방법론, Jaimini Sutras까지 모두 **PyJHora**와 교차 검증되었습니다.

## 계산 가능한 항목

| 카테고리 | 커버리지 |
|---|---|
| **다샤(Dasha)** | 10개 시스템 (Vimshottari + 9개 대체) × 5레벨 = **50개 엔드포인트** |
| **바르가(Varga)** | Shodasha varga D1–D60을 단일 호출로 |
| **판찬가(Panchang)** | 티티(Tithi), 카라나(Karana), 요가(Yoga), 나크샤트라(Nakshatra), 초가디아(Chogadia), 호라(Hora), 라후 칼라(Rahu-kaal), 완전 지원 |
| **샤드발라(Shadbala)** | 6가지 힘: 스탄나(Sthana) + 딕(Dig) + 칼라(Kala) + 체슈타(Cheeshta) + 나이사르기카(Naisargika) + 드릭(Drik) + 완전 |
| **요가(Yoga)** | Parashara (라자, 다나, 다르마-카르마디파티, Pancha-Mahapurusha, 가자케사리, 아디) + Jaimini (카라카-요가, 카라캄사, 슈바-그라하) |
| **도샤(Dosha)** | Parashara (망갈, 칼-사르프, 피트루, 슈라피트, 그라한, 구루-찬달) + Lal Kitab 망갈릭 + KP |
| **호환성(Compatibility)** | 아슈타쿳(Ashtakut, 8가지 군-밀란), 다샤코타, 망갈릭-체크, 망갈-메치, 브리구-메치 |
| **무후르타(Muhurta)** | 선거 점성술 — 결혼, 자동차, 사업, 여행, 출생, 수술, 교육, 투자, 부동산, 그리하 프라베시, 약혼, 소송 |
| **랄 키타브(Lal Kitab)** | 완전한 패키지: 차트, 그라하, 리시, 타트바스, 바르가스, 우파야 |
| **KP** | Krishnamurti Paddhati (지배 행성, 서브-로드 이론, KP 요가/도샤) |
| **자이미니(Jaimini)** | 카라키, 차라-카라키, 파다스, 우파파다, 아스펙트, 드리슈티, 아트마카라카-나밤샤, Daha-summary, 요가 + extras: 카라카-요가, 카라캄사, 아트마카라카-로테이션, 아르갈라 분석 |

## 예시: 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: ${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"현재 MD: {data['current']['lord']} ~ {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: {$data['current']['lord']} ~ {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## 경쟁사와 차별화된 기능

다른 API에서 제공하지 않는 엔드포인트:

- **10개의 다샤 시스템** (드문 Tribhagi, Shatabdika, Shodashottari, Sthira, Shoola 포함 — 대부분 API는 Vimshottari만 제공)
- **Karakamsa를 12-house 차트로** — 이슈타-데바타 + Moksha 값과 함께 완전한 프로젝션
- **Argala 분석** — 12개의 Houses에 대한 아르갈라 + 비로드갈라 스캔과 netInfluence 메트릭
- **Atmakaraka 로테이션** — 인생 이벤트 트리거와 함께 프로그레시브 AK
- **Cross-school doshas** — Parashara + Lal Kitab + KP를 단일 API에서 (대부분은 한 학교만 제공)

## 사용 사례

- **인도 점성술 앱** (Pratyangira, Drik Panchang, AstroSage 등) — 자체 에페메리드 없이 완전한 백엔드
- **결혼 호환성 매칭** — Ashtakut + Dashakoota + Manglik을 단일 호출로
- **모바일 호로스코프 앱** — `/v1/vedic/panchang/full`을 통한 매일 Панчанг (8개 요소 한 번의 요청으로)
- **선거 점성술 서비스** (출생, 결혼 무후르타) — `/v1/vedic/muhurat/*` 12가지 이벤트 유형
- **베다 호환성 서비스** — `/v1/vedic/compatibility/full`을 통한 완전한 리포트

## 정확성

모든 계산은 **Swiss Ephemeris** (sub-arcsecond precision)에 기반하며, **PyJHora** (Python의 사실상 표준 구현)와 교차 검증되었습니다. 차이가 있는 경우 `docs/AUDIT-TRAIL.md`에 문서화되어 있습니다.

다른 전통(랄 키타브, KP, 자이미니)을 따르는 학교는 **YELLOW 마크**가 표시된 엔드포인트에서 single-author method(랄 키타브 — Pt. Roop Chand Joshi only)를 사용합니다. 통합자는 канони성 수준을 확인할 수 있습니다.

## 현지화

베다 리포트는 **20개 언어**로 제공됩니다 (T0 수동, T1 AI 베타 — [`/languages/`](/languages/) 참고). `/v1/reports/*` 엔드포인트에 `lang=<code>`를 전달하세요.

## 가격 정책

대부분의 베다 엔드포인트는 **Tier 2 (20크레딧)**입니다. 큰 리포트(완전한 호환성, 무후르타 스캐너)는 Tier 3 (50크레딧)입니다. PDF 리포트(Lal Kitab / Vedic Kundli)는 Tier 7 (5000크레딧)입니다.

Free 플랜에서는 **매월 500회의 무료 베다 호출**을 제공합니다.

<CardGrid>
  <LinkCard title="엔드포인트 카테고리 →" href="/vedic/" description="다샤, 바르가, 판찬가, 샤드발라, 요가, 도샤, 호환성, 무후르타" />
  <LinkCard title="빠른 시작" href="/getting-started/" description="5분 안에 첫 번째 요청 보내기" />
  <LinkCard title="요금제" href="/pricing/" description="무료부터 엔터프라이즈까지" />
  <LinkCard title="언어 지원" href="/languages/" description="20개 언어 — 베다 리포트" />
</CardGrid>