Astrologia Védica por meio da API: desde Parashara até Lal Kitab em 354 endpoints

A astrologia Védica é a tradição astrológica contínua mais antiga do mundo. Suas metodologias formais (BPHS, Jaimini Sutras, Lal Kitab, KP) são utilizadas diariamente na Índia: para combinações matrimoniais, escolha de datas, diagnóstico proativo do destino. Mas acessar computacionalmente cálculos de qualidade - até recentemente era doloroso.

AstroWay v2.19 corrige isso: 354+ pontos de acesso Védicos, verificados cruzadamente contra PyJhora (implementação de referência em Python), com divergências documentadas.

Embora ambos os zodíacos sejam calculados a partir das mesmas posições dos planetas (por meio do Swiss Ephemeris), conceitualmente eles são distintos:

Védico não é uma “alternativa” ao ocidental — é um sistema separado com seu próprio esqueleto lógico interno. Integradores que fazem aplicativos multi-tradição (goroscópio móvel, combinação, horóscopo diário), frequentemente querem ambos — e aqui um API em vez de dois terceiros — é uma economia séria.

A maioria dos concorrentes — apenas Vimshottari (ciclo de 120 anos, o mais popular). AstroWay cobre:

1. Vimshottari (120 anos) — padrão BPHS, completo
2. Yogini (36 anos) — previsões mais rápidas, 8 planetas
3. Ashtottari (108 anos) — tradição Ardradi, recomendação paksha
4. Kalachakra (signos como senhores de MD) — sistema mais complexo, paramayu varia por carta
5. Chara (Jaimini móvel) — para previsões baseadas em signos
6. Tribhagi (54 = Vimshottari/2 + extras) — Vimshottari acelerado
7. Shatabdika (100 anos) — contagens de fontes variadas
8. Shodashottari (116 anos) — para cartas paksha-mistas
9. Sthira (período fixo raro)
10. Shoola (método cross-rasi)

Cada um suporta 5 níveis: Maha → Antar → Pratyantar → Sookshma → Prana.

Cartas divisórias — são olhares recursivos para a mesma carta natal em diferentes escalas. D9 (Navamsha) — mais importante para casamento. D10 (Dashamsha) — carreira. D60 (Shashtyamsha) — nível mais fino.

Uma chamada para /v1/vedic/vargas retorna todos os 16 divisores de uma vez — o integrador não precisa fazer 16 solicitações separadas.

5 elementos + auxiliares:

• Tithi (dia lunar, 30 divisões do ciclo lunar)
• Karana (meio-tithi, 11 tipos)
• Yoga (yoga diário, 27 tipos, baseado na soma das longitudes do Sol + Lua)
• Nakshatra (um dos 27 mansions lunares)
• Choghadia (8 blocos de meia hora de auspiciosidade)
• Hora (hora planetária)
• Rahu-kaal (janela inauspiciosa de 1,5 horas por dia)

Chamando /v1/vedic/panchang/full — obtém todos os 8 elementos em um único JSON para uma data/Localização específica.

Yoga em Védico — é uma combinação planetária especial, que forma um padrão de vida notável. Parashara (BPHS) descreve centenas; AstroWay implementa os mais citados:

• Raja — combinações de poder/reconhecimento
• Dhana — riqueza
• Dharma-Karmadipati — caminho profissional
• Pancha-Mahapurusha — Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 planetas em casas kendra em seus próprios signos)
• Gajakesari — Lua + Júpiter em kendra
• Adhi — Mercúrio/Vênus/Júpiter em 6/7/8 a partir da Lua

Mais Jaimini-específicos: karaka-yoga (8 chara-karaka em casas significativas), karakamsa (projeção de 12 casas com AK em D9), shubha-graha (benéfico funcional por BPHS Adhyaya 34).

Doṣa — é uma aflição planetária, que complica uma esfera específica da vida. AstroWay cobre três escolas:

• Parashara: Mangal Doṣa (Marte), Kaal Sarp (planetas entre Rahu e Ketu), Pitru (karma ancestral), Shrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (interpretação específica do Lal Kitab), mais outros doṣas exclusivos desta escola
• KP (Krishnamurti Paddhati): diagnósticos baseados em sub-senhor

Se o seu combinação de casamento atende clientes de diferentes regiões da Índia (Punjab frequentemente usa LK, Tamil Nadu — KP, todos — Parashara) — um API em vez de três.

Processo de combinação clássico indiano:

1. Ashtakoot (Guna Milan) — escala de 8 pontos, 36 pontos máximo. Menos de 18 = baixa compatibilidade. Mais popular no norte/centro da Índia.
2. Dashakoota — variante de 10 pontos, sul-indiana.
3. Verificação Manglik — crítica para cartas natais afetadas por Marte.
4. Combinação Mangal — compensa Marte-Marte.
5. Combinação Bhrigu — overlay preditivo com Bhrigu Samhita.

Tudo através de /v1/vedic/compatibility/full — uma chamada, relatório completo de compatibilidade.

“Muhurta” — é o momento auspicioso do tempo para iniciar um evento. Eventos clássicos:

• Muhurta de casamento (casamento)
• Compra de veículo (auto)
• Início de negócios (abertura de negócios)
• Viagem (viagem)
• Cerimônia de nomeação (Namakaran — nomeação do bebê)
• Cirurgia, início de educação, investimento, compra de propriedade, griha-pravesh (nova casa), noivado, casos judiciais

/v1/vedic/muhurat/{event} retorna as 3 datas mais auspiciosas em um intervalo de tempo especificado.

Lahiri — padrão (Chitra-Paksha, padrão oficial do governo indiano). Através do parâmetro ayanamsa é possível alternar:

• raman — tradição B.V. Raman (popular em KP)
• krishnamurti — específico do KP
• yukteshwar — Sri Yukteshwar (distância de Spica)
• fagan-bradley — Fagan/Bradley (sideral ocidental)
• de-luce — De Luce
• jn-bhasin — JN Bhasin

Cada um — é um offset diferente (geralmente 23,5–24,0°). Para o mesmo cliente, as posições dos planetas nos signos podem diferir — é importante saber desde a etapa de arquitetura do seu aplicativo.

Cada ponto de acesso tem:

• Status (VERDE/AMARELO) em docs/AUDIT-TRAIL.md
• Cabeçalho de auditoria inline no código-fonte com fontes (BPHS Adhyaya N, Jaimini Sutras X.Y, função de referência PyJhora)
• Fixture de teste de instantâneo para regressão

Divergências com PyJhora (onde existem — mais frequentemente para metodologias de autor único como Lal Kitab) são documentadas no AUDIT-TRAIL — o integrador vê o delta exato antes de integrar.

# Carta natal Védica
curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "tzOffset": "+03:00",
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Retorna o senhor atual do Maha-dasha, data final do MD, sequência de dashas subsequentes. Através de /maha → /antar → /pratyantar → … é possível mergulhar até 5 níveis.

Relatórios Védicos (PDF) estão disponíveis em 20 idiomas, incluindo hi, ko, ja, id, tr, vi — mercados com demanda real por conteúdo Védico. Envie lang=<código> em qualquer ponto de acesso /v1/reports/*. Detalhes — /languages/.

A maioria dos pontos de acesso Védicos — Nível 2 (20 créditos). No plano gratuito — 500 chamadas Védicas por mês. Relatórios grandes (compatibilidade completa, scanner de muhurat) — Nível 3 (50 cr). Relatórios PDF Védicos Kundli / Lal Kitab — Nível 7 (5000 cr).

• Categorias de pontos de acesso Védicos — navegação por 8 grupos
• Marketing de API Védica — visão geral completa com exemplos de código em 4 idiomas
• Início rápido — primeiro pedido em 5 minutos
• Preços — desde gratuito até Enterprise