API Muhurta - Seleção de Datas Favoráveis (Astronomia Védica)
Muhurta - é uma eletiva astrologia védica: escolha de um momento auspicioso para um evento importante. A API verifica cada dia na sua janela de pesquisa, avalia-o segundo o Panchanga ao nascer do sol (Tithi · Vara · Nakshatra · Yoga · Karana) para uma atividade específica e devolve os top-N melhores dias com explicação.
Como funciona
Seção intitulada “Como funciona”- Selecione a atividade (uma das 12: lista através de
/muhurta/types), a janela de pesquisa (até 90 dias) e a localização (o nascer do sol está vinculado às coordenadas) - A API calcula o Panchanga ao nascer do sol para cada dia e avalia-o segundo as regras clássicas de atividade (Muhurta Chintamani + B.V. Raman)
- Resposta: top-N dias, ordenados por score, com Panchanga, sub-janela Abhijit Muhurat e fatores de avaliação (
why)
Endpoints
Seção intitulada “Endpoints”| Endpoint | Method | Credits | Purpose |
|---|---|---|---|
/v1/muhurta/types | GET | 0 | Catálogo de 12 atividades (chave + sânscrito + descrição) |
/v1/vedic/muhurat/{activity} | POST | Tier 3 | Escaneamento da janela para uma atividade → top-N dias (JSON) |
/v1/reports/muhurta | POST | Tier 7 | Relatório pronto de datas auspiciosas - PDF (padrão) ou HTML (?format=html) |
12 atividades
Seção intitulada “12 atividades”marriage (Vivah) · vehicle-purchase (Vahana) · business-start (Vyapara) · travel (Yatra) · naming-ceremony (Namkaran) · surgery (Shastrakarma) · education-start (Vidyarambha) · investment (Dhana Sthapana) · property-purchase (Griha Pravesh) · journey-long · name-change · general-auspicious.
Relatório
Seção intitulada “Relatório”POST /v1/reports/muhurta devolve um relatório padrão A4 da mesma forma que o resto de /v1/reports/* - renderização síncrona na resposta: PDF por padrão, ?format=html devolve HTML sem renderização. A recomendação principal, lista ordenada de dias, Panchanga de cada dia, Abhijit Muhurat e fatores de avaliação como justificação. Suporta white-label (logotipo/cores/fonte) para chaves vinculadas à conta.
Exemplo
Seção intitulada “Exemplo”curl -X POST https://api.astroway.info/v1/reports/muhurta \ -H "X-Api-Key: aw_live_..." \ -H "Content-Type: application/json" \ -d '{ "activity": "marriage", "search_window_start": "2026-07-01", "search_window_end": "2026-07-31", "latitude": 28.61, "longitude": 77.21, "timezoneOffset": 5.5, "topN": 5 }'# → { "url": "https://api.astroway.info/reports/…-muhurta.pdf", "page_count": 3, "expires_at": "…" }# (?format=html повертає HTML напряму)