curl -X POST https://api.occultapi.com/api/astro/panchanga_yogas/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'Um Panchanga yoga é uma qualidade com nome próprio, boa ou ruim, que marca o dia inteiro e resulta da combinação do dia lunar (tithi), do dia da semana (vaara) e da mansão lunar (nakshatra) daquele dia. Sarvartha Siddhi ("todos os objetivos se realizam"), Amrit Siddhi, Tripushkara, Dagdha, Mrityu e Yamaghanta são os mais conhecidos. A prática de muhurta os usa como primeiro filtro: escolha um dia com uma combinação benéfica e evite um dia com uma maléfica. Esta é a varredura por dia. Ela percorre cada dia do calendário do ano solicitado, avalia os yogas uma única vez, no nascer do sol daquele dia, e retorna apenas os dias que têm pelo menos um. A resposta é `data.days`, uma lista de `{date, yogas}` em que `date` é `YYYY-MM-DD` e `yogas` é uma lista de nomes; os dias sem nada a informar ficam totalmente de fora. A maioria dos nomes traz entre parênteses a convenção de origem, por exemplo "Amrit Yoga (Vaara Tithi Yoga)" ou "Padma Yoga (Vashishta Samhita Yogas)", porque vários textos clássicos definem conjuntos que se sobrepõem. Os yogas são lidos no nascer do sol, então a latitude, a longitude e `timezone_as_float` alteram o resultado. O padrão de `use_28_nakshatras` é true, o que insere Abhijit como um nakshatra independente; alguns yogas, como o Kaana Yoga de segunda-feira, são definidos em termos de Abhijit e não podem aparecer sem ele. Defina como false para usar a lista simples de 27 nakshatras. Este endpoint não tem relação com `/api/astro/yogas/`, que encontra combinações de planetas em um mapa natal; nada aqui consulta um mapa natal. Para o Ravi Yoga especificamente, `/api/astro/ravi_yoga/` fornece horários exatos de início e fim, em vez de uma flag por dia.
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| latitude | number (double) | obrigatório | Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. |
| longitude | number (double) | obrigatório | Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. |
| timezone_as_float | number (double) | obrigatório | Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. |
| year | integer | obrigatório | Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2400 |
| use_28_nakshatras | boolean | opcional |