# ベーダ API

AstroWay API には **354以上のベーダー占星術エンドポイント** があり、商用 API の中でも Jyotish のカバレッジが最も充実しています。古典的な BPHS-Parashara、完全な Lal Kitab、KP メソッド、Jaimini Sutras まで、すべて PyJHora とのクロスチェックが行われています。

## 計算される内容

| カテゴリー | カバレッジ |
|---|---|
| **ダシャ** | 10システム (Vimshottari + 9代替) × 5レベル = **50エンドポイント** |
| **ヴァルガ** | Shodasha varga D1–D60 を1回のリクエストで |
| **パンチャング** | ティティ、カラナ、ヨーガ、ナクシャトラ、チョーガディア、ホーラ、ラーフ・カール、完全版 |
| **シャドバラ** | 6重の力: スターナ + ディグ + カラ + チェシュタ + ナイサルギカ + ドリク + 完全版 |
| **ヨーガ** | Parashara (ラージャ、ダーナ、ダルマ・カルマーディパティ、Pancha-Mahapurusha、ガジャケサリ、アディ) + Jaimini (カラカ・ヨーガ、カラカムサ、シュバ・グラハ) |
| **ドーシャ** | Parashara (マンガラ、カール・サルプ、ピトリ、シュラピット、グラハナ、グル・チャンダラ) + Lal Kitab Manglik + KP |
| **相性** | アシュタクート (8重のグナ・ミラン)、ダシャコータ、マンガリカ・チェック、マンガル・メチャ、ブリグ・メチャ |
| **ムフルタ** | 選挙占星術 — 結婚、車、ビジネス、旅行、命名、手術、教育、投資、不動産、グリハ・プラヴェーシュ、婚約、裁判 |
| **Lal Kitab** | 完全パッケージ: チャート、グラハ、リシ、タットヴァス、ヴァルガス、ウパーヤ |
| **KP** | Krishnamurti Paddhati (支配惑星、サブ・ロード理論、KP ヨーガ/ドーシャ) |
| **Jaimini** | カラキ、チャラ・カラキ、パーダス、ウパパーダ、アスペクト、ドリシュティ、アートマカラカ・ナヴァムシャ、ダーシャ・サマリー、ヨーガ + 追加: カラカ・ヨーガ、カラカムサ、アートマカラカ・ローテーション、アルガラ解析 |

## 例: ヴィムショッタリ・ダシャ

<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ハウスチャートとして** — イシュタ・デヴァターとモークシャ値を含む完全な投影
- **Argala 解析** — 12ハウス全てのアルガラ + ヴィロードハルガラをネットインフルエンス指標付きで完全スキャン
- **Atmakaraka ローテーション** — ライフイベントトリガー付きの人生を通した進行アートマカラカ
- **クロススクール・ドーシャ** — Parashara + Lal Kitab + KP を1つの API で (多くの API は1つの流派のみ対応)

## 利用シーン

- **インド占星術アプリ** (Pratyangira、Drik Panchang、AstroSage など) — 自前のエフェメリスなしで完全なバックエンドを実現
- **結婚相性サービス** — アシュタクート + ダシャコータ + マンガリカを1回のリクエストで
- **モバイルホロスコープアプリ** — `/v1/vedic/panchang/full` 経由で毎日パンチャング (8要素を1リクエストで)
- **選挙占星術サービス** (命名、結婚式のムフルタ) — `/v1/vedic/muhurat/*` で12種類のイベントに対応
- **ベーダー相性サービス** — `/v1/vedic/compatibility/full` 経由で完全レポートを取得

## 精度

すべての計算は **Swiss Ephemeris** (サブ秒精度) に基づいており、 **PyJHora** (Python における事実上のリファレンス実装) とのクロスチェックが行われています。相違点がある場合は `docs/AUDIT-TRAIL.md` に文書化されています。

異なる伝統を持つ流派 (Lal Kitab、KP、Jaimini) には、シングルオーサー方式のエンドポイント (例: Lal Kitab は Pt. Roop Chand Joshi のみ) に **YELLOW マーク** が付けられています。これにより、インテグレーターは正当性のレベルを確認できます。

## ローカライズ

ベーダーレポートは **20言語** に対応しています (T0: 手動、T1: AI Beta — 詳細は [`/languages/`](/languages/) を参照)。どの `/v1/reports/*` エンドポイントでも `lang=<code>` を指定できます。

## 料金体系

ほとんどのベーダーエンドポイントは **Tier 2 (20クレジット)** です。大規模レポート (完全相性、ムフルタスキャナー) は Tier 3 (50クレジット)、Lal Kitab / Vedic Kundli の PDF レポートは Tier 7 (5000クレジット) です。

無料プランでは **月に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>