# API Védica

A API AstroWay tem **354+ endpoints de astrologia védica** — a cobertura mais completa de Jyotish entre as APIs comerciais. O clássico Bṛhat Parāśara Horā Śāstra (BPHS), Lal Kitab completo, o método KP, os aforismos de Jaimini — tudo foi cruzado e verificado contra o PyJHora.

## O que é calculado

| Categoria | Cobertura |
|---|---|
| **Dashas** | 10 sistemas (Vimshottari + 9 alternativos) × 5 níveis = **50 endpoints** |
| **Vargas** | Shodasha varga D1–D60 num único pedido |
| **Panchang** | Tithi, Karana, Yoga do dia, Nakshatra do dia, Chogadia, Hora, Rahu Kaal, completo |
| **Shadbala** | Seis forças: Sthana + Dig + Kala + Cheshta + Naisargika + Drik + completo |
| **Yogas** | Parāśara (Rāja, Dāna, Dharma-Karmādhipati, Pancha-Mahapurusha, Gajakesari, Adhi) + Jaimini (karaka-yoga, karakamsa, shubha-graha) |
| **Doshas** | Parāśara (Mangala, Kala-Sarpa, Pitru, Shrapit, Grahana, Guru-Chandal) + Lal Kitab Manglik + KP |
| **Compatibilidade** | Ashtakoota (Guna Milan de 8 pontos), Dashakoota, Manglik-check, Mangal-dosha, Bhrigu-dosha |
| **Muhurta** | Eleitoral — casamento, carro, negócios, viagem, nomeação, cirurgia, educação, investimentos, imobiliária, Griha Pravesh, noivado, processo judicial |
| **Lal Kitab** | Pacote completo: mapa, grahas, rishis, tattvas, Vargas, upayas |
| **KP** | Krishnamurti Paddhati com planetas regentes, teoria do sub-lord, yogas/doshas KP |
| **Jaimini** | Karakas, Chara Karakas, Padas, Upapadas, Aspectos, Drishtis, Atmakaraka-Navamsa, Daha-summary, Yogas + extras: karaka-yoga, karakamsa, atmakaraka-rotation, argala-analysis |

## Exemplo: Dashas 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_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 atual: ${data.current.lord} até ${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 atual: {data['current']['lord']} até {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 atual: {$data['current']['lord']} até {$data['current']['endDate']}\n";
    ```
  </TabItem>
</Tabs>

## Funcionalidades exclusivas

Endpoints que não existem em nenhuma outra API concorrente:

- **10 sistemas de dashas**, incluindo os raros Tribhagi, Shatabdika, Shodashottari, Sthira e Shoola (a maioria das APIs só tem Vimshottari)
- **Karakamsa como mapa de 12 casas** — projeção completa com ishta-devata + valores de moksha
- **Análise de Argala** — varredura completa de Argala + Virodhargala em 12 casas com métrica de `netInfluence`
- **Rotação de Atmakaraka** — progressão de AK ao longo da vida com gatilhos de eventos de vida
- **Doshas de escolas cruzadas** — Parāśara + Lal Kitab + KP numa única API (a maioria oferece apenas uma escola)

## Quem usa

- **Apps de astrologia indiana** (semelhantes a Pratyangira, Drik Panchang, AstroSage) — backend completo sem necessidade de efemérides próprias
- **Serviços de casamento** — Ashtakoota + Dashakoota + Manglik num único pedido
- **Apps de horóscopo móvel** — Panchang diário via `/v1/vedic/panchang/full` (8 elementos num único pedido)
- **Serviços eleitorais** (nomeação de criança, muhurta de casamento) — `/v1/vedic/muhurat/*` com 12 tipos de eventos
- **Serviços de compatibilidade védica** — relatório completo via `/v1/vedic/compatibility/full`

## Precisão

Todos os cálculos são baseados no **Swiss Ephemeris** (precisão sub-segundo de arco) e verificados contra o **PyJHora** (implementação de referência em Python). As raras divergências existentes estão documentadas em `docs/AUDIT-TRAIL.md`.

As escolas com tradições diferentes (Lal Kitab, KP, Jaimini) têm marcações **AMARELO** nos endpoints onde o método é de um único autor (Lal Kitab — apenas Pt. Roop Chand Joshi) — o integrador vê o nível de canonicidade.

## Localização

Os relatórios védicos estão disponíveis em **21 línguas** (T0 manual, T1 IA Beta — veja [`/languages/`](/languages/)). Passa `lang=<code>` em qualquer endpoint `/v1/reports/*`.

## Preços

A maioria dos endpoints védicos é **Tier 2 (20 créditos)**. Relatórios grandes (compatibilidade completa, scanner de muhurta) são Tier 3 (50 créditos). Relatórios em PDF de Lal Kitab / Kundli védico são Tier 7 (5000 créditos).

No plano Free — **500 pedidos védicos por mês grátis**.

<CardGrid>
  <LinkCard title="Categorias de endpoints →" href="/vedic/" description="Dashas, Vargas, Panchang, Shadbala, Yogas, Doshas, Compatibilidade, Muhurta" />
  <LinkCard title="Primeiros passos" href="/getting-started/" description="Faz o primeiro pedido em 5 minutos" />
  <LinkCard title="Preços" href="/pricing/" description="Do plano Free ao Enterprise" />
  <LinkCard title="Suporte de línguas" href="/languages/" description="21 línguas — relatórios védicos" />
</CardGrid>