# API Vedic

AstroWay API propose **354+ endpoints d'astrologie védique** — la couverture la plus complète de Jyotish parmi les API commerciales. Le classique Bṛhat Parāśara Horā Śāstra (BPHS), le Lal Kitab complet, la méthodologie KP, les sūtras de Jaimini — tout est croisé et vérifié contre PyJHora.

## Ce qui est calculé

| Catégorie | Couverture |
|---|---|
| **Daśās** | 10 systèmes (Vimśottari + 9 alternatives) × 5 niveaux = **50 endpoints** |
| **Vargas** | Shodasha varga D1–D60 en un seul appel |
| **Pañcāṅga** | Tithi, Karaṇa, Yoga du jour, Nakṣatra du jour, Chogadia, Hora, Rāhu-kāla, complet |
| **Śadbala** | Force en 6 parties : Sthāna + Dig + Kala + Ceṣṭa + Naisargika + Dṛk + complet |
| **Yogas** | Paraśara (Rāja, Dāna, Dharma-Karmādipati, Pañca-Mahāpuruṣa, Gajakeśarī, Adhī) + Jaimini (karaka-yoga, karakāṃśa, śubha-graha) |
| **Doṣas** | Paraśara (Mangala, Kāla-Sarpa, Pitṛ, Śrapit, Grahaṇa, Guru-Caṇḍāla) + Lal Kitab Maṅgalik + KP |
| **Compatibilité** | Aṣṭakūṭa (8-fold Guna-Mīlana), Daśakoṭa, Maṅgalik-check, Maṅgala-mec, Bhṛgu-mec |
| **Muhūrta** | Électif — mariage, voiture, business, voyage, nomination, opération, éducation, investissement, immobilier, gṛha-praveśa, fiançailles, procès |
| **Lal Kitab** | Pack complet : chart, grahas, ṛṣis, tattvas, vargas, upāya |
| **KP** | Krishnamurti Paddhati avec ruling planets, théorie des sub-lords, yogas/doṣas KP |
| **Jaimini** | Kārakas, Cara-kārakas, Pādas, Upapādas, Aspects, Dṛṣṭis, Ātmakāraka-Navamśa, Daha-summary, Yogas + extras : karaka-yoga, karakāṃśa, atmakāraka-rotation, argala-analysis |

## Exemple : Daśā Vimśottari

<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 actuel : ${data.current.lord} jusqu'au ${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 actuel : {data['current']['lord']} jusqu'au {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 actuel : {$data['current']['lord']} jusqu'au {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Fonctionnalités uniques

Endpoints absents chez les concurrents :

- **10 systèmes de daśā** incluant les rares Tribhagi, Śatābdika, Śodāśottari, Sthira, Śūla (la plupart des API n'ont que Vimśottari)
- **Karakāṃśa comme chart de 12 maisons** — projection complète avec iṣṭa-devatā + valeurs de mokṣa
- **Analyse Argala** — scan complet d'Argala + Virodhārgalas sur 12 maisons avec métrique netInfluence
- **Rotation d'Ātmakāraka** — progression d'ĀK à travers la vie avec déclencheurs d'événements
- **Doṣas inter-écoles** — Paraśara + Lal Kitab + KP dans une seule API (la plupart ne proposent qu'une seule école)

## Qui l'utilise

- **Applications d'astrologie indienne** (équivalents de Pratyangira, Drik Panchang, AstroSage) — backend complet sans avoir besoin de sa propre éphéméride
- **Services de compatibilité matrimoniale** — Aṣṭakūṭa + Daśakoṭa + Maṅgalik en un seul appel
- **Applications mobiles d'horoscopes** — Pañcāṅga quotidien via `/v1/vedic/panchang/full` (8 éléments en 1 requête)
- **Services muhūrta** (électionnel : nomination d'enfant, muhūrta de mariage) — `/v1/vedic/muhurat/*` pour 12 types d'événements
- **Services de compatibilité védique** — rapport complet via `/v1/vedic/compatibility/full`

## Précision

Tous les calculs reposent sur **Swiss Ephemeris** (précision sous-seconde d'arc) + vérification croisée contre **PyJHora** (implémentation de référence en Python). Les divergences, lorsqu'elles existent, sont documentées dans `docs/AUDIT-TRAIL.md`.

Les écoles de différentes traditions (Lal Kitab, KP, Jaimini) ont des marqueurs **JAUNE** distincts pour les endpoints utilisant une méthode d'un seul auteur (Lal Kitab — uniquement Pt. Roop Chand Joshi) — l'intégrateur voit ainsi le niveau de canonicité.

## Localisation

Les rapports védiques sont disponibles en **20 langues** (T0 manuellement, T1 IA Bêta — voir [`/languages/`](/languages/)). Passe `lang=<code>` à n'importe quel endpoint `/v1/reports/*`.

## Tarification

La plupart des endpoints védiques sont en **Tier 2 (20 crédits)**. Les grands rapports (compatibilité complète, scanner muhūrta) sont en Tier 3 (50 crédits). Les rapports PDF Lal Kitab / Vedic Kundli sont en Tier 7 (5000 crédits).

Avec le forfait Free, tu as **500 appels védiques par mois gratuits**.

<CardGrid>
  <LinkCard title="Catégories d'endpoints →" href="/vedic/" description="Daśās, Vargas, Pañcāṅga, Śadbala, Yogas, Doṣas, Compatibilité, Muhūrta" />
  <LinkCard title="Démarrage rapide" href="/getting-started/" description="Première requête en 5 minutes" />
  <LinkCard title="Tarifs" href="/pricing/" description="Du gratuit à l'Enterprise" />
  <LinkCard title="Support des langues" href="/languages/" description="20 langues — rapports védiques" />
</CardGrid>