# API Védica

AstroWay API tiene **354+ endpoints de astrología védica** — la cobertura más completa de Jyotish entre las APIs comerciales. El clásico Bṛhat Parāśara Horā Śāstra, el completo Lal Kitab, el método KP, los aforismos de Jaimini — todo está cruzado y verificado frente a PyJHora.

## ¿Qué se calcula?

| Categoría | Cobertura |
|---|---|
| **Dasha** | 10 sistemas (Vimshottari + 9 alternativos) × 5 niveles = **50 endpoints** |
| **Varga** | Shodasha varga D1–D60 en una sola llamada |
| **Panchang** | Tithi, Karana, Yoga del día, Nakshatra del día, Chogadia, Hora, Rahu Kaal, completo |
| **Shadbala** | Fuerza de 6 facetas: Sthana + Dig + Kala + Cheshta + Naisargika + Drik + completo |
| **Yogas** | Parāśara (Raja, Dāna, Dharma-Karmādhipati, Pancha-Mahapurusha, Gajakesari, Adhi) + Jaimini (karaka-yoga, karakamsa, shubha-graha) |
| **Dosh** | Parāśara (Mangal, Kala-Sarpa, Pitru, Shrapit, Grahan, Guru-Chandal) + Lal Kitab Manglik + KP |
| **Compatibilidad** | Ashtakoota (Gun-Milan de 8 facetas), Dashakoota, Manglik-check, Mangal-Mech, Brihu-Mech |
| **Muhurta** | Electivo — boda, auto, negocio, viaje, nombre, operación, educación, inversiones, bienes raíces, griha-pravesh, compromiso, juicio |
| **Lal Kitab** | Paquete completo: carta, grahas, rishis, tattvas, Vargas, upaya |
| **KP** | Krishnamurti Paddhati con planetas regentes, teoría de sub-lords, yogas/doshas KP |
| **Jaimini** | Karakas, Chara-karakas, Padas, Upapadas, Aspectos, Drishti, Atmakaraka-Navamsa, Daha-summary, Yogas + extras: karaka-yoga, karakamsa, atmakaraka-rotation, argala-analysis |

## Ejemplo: Dasha Vimshottari

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

## Funcionalidades únicas

Endpoints que no encontrarás en la competencia:

- **10 sistemas de dasha** incluyendo los raros Tribhagi, Shatabdika, Shodashottari, Sthira, Shoola (la mayoría de APIs solo tienen Vimshottari)
- **Karakamsa como carta de 12 casas** — proyección completa con ishta-devata + valores moksha
- **Argala-analysis** — escaneo completo de Argalas + Virodhargalas en las 12 casas con métrica de netInfluence
- **Atmakaraka-rotation** — progresión de AK a través de la vida con triggers de eventos vitales
- **Cross-school doshas** — Parāśara + Lal Kitab + KP en una sola API (la mayoría solo ofrecen una escuela)

## ¿Quién lo usa?

- **Apps de astrología india** (como Pratyangira, Drik Panchang, AstroSage) — backend completo sin necesidad de efemérides propias
- **Servicios de compatibilidad matrimonial** — Ashtakoota + Dashakoota + Manglik en una sola llamada
- **Apps de horóscopo móvil** — Panchang diario a través de `/v1/vedic/panchang/full` (8 elementos en 1 petición)
- **Servicios electivos** (nombramiento de niños, muhurta de boda) — `/v1/vedic/muhurat/*` para 12 tipos de eventos
- **Servicios de compatibilidad védica** — informe completo a través de `/v1/vedic/compatibility/full`

## Precisión

Todos los cálculos se basan en **Swiss Ephemeris** (precisión de sub-segundos de arco) + verificación cruzada contra **PyJHora** (implementación de referencia *de facto* en Python). Las discrepancias existentes están documentadas en `docs/AUDIT-TRAIL.md`.

Las escuelas con diferentes tradiciones (Lal Kitab, KP, Jaimini) tienen marcas **AMARILLAS** en los endpoints donde el método es de un solo autor (Lal Kitab — solo Pt. Roop Chand Joshi) — el integrador ve el nivel de canonicidad.

## Localización

Los informes védicos están disponibles en **20 idiomas** (T0 manual, T1 Beta con IA — ver [`/languages/`](/languages/)). Envía `lang=<code>` en cualquier endpoint `/v1/reports/*`.

## Precios

La mayoría de los endpoints védicos son **Tier 2 (20 créditos)**. Los informes grandes (compatibilidad completa, escáner de muhurta) son Tier 3 (50 créditos). Los informes en PDF de Lal Kitab / Kundli védico son Tier 7 (5000 créditos).

En el plan Free — **500 llamadas védicas al mes gratis**.

<CardGrid>
  <LinkCard title="Categorías de endpoints →" href="/vedic/" description="Dasha, Varga, Panchang, Shadbala, Yogas, Dosh, Compatibilidad, Muhurta" />
  <LinkCard title="Primeros pasos" href="/getting-started/" description="Tu primera petición en 5 minutos" />
  <LinkCard title="Precios" href="/pricing/" description="Desde free hasta Enterprise" />
  <LinkCard title="Soporte de idiomas" href="/languages/" description="20 idiomas — informes védicos" />
</CardGrid>