curl -X POST https://api.occultapi.com/api/panchpakshi/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"fixed":true,"datetime":"2024-11-21T09:39:20.910Z","latitude":26.1046,"longitude":74.319,"timezone_as_float":5.5}'O Pancha Pakshi é um sistema sul-indiano de escolha de horários que atribui a cada pessoa uma de cinco aves — abutre, coruja, corvo, galo ou pavão — e divide o dia em dez períodos chamados yamas, cinco entre o nascer e o pôr do sol e cinco entre o pôr do sol e o nascer do sol seguinte. Na tradição completa, cada ave passa por cinco estados de atividade (reinar, comer, caminhar, dormir e morrer) ao longo desses períodos, e as atividades são marcadas para os períodos em que a sua própria ave está forte. Este endpoint retorna os dois dados em que esse esquema se apoia: os limites dos yamas para um dia e um local, e a ave de nascimento para um momento. `datetime`, `latitude`, `longitude` e `timezone_as_float` definem o dia e o local. `fixed` escolhe como o dia é dividido: false usa o nascer e o pôr do sol locais reais, então os yamas diurnos e noturnos têm durações diferentes e se deslocam ao longo do ano; true usa um dia fixo das 06:00 às 18:00, o que dá dez períodos iguais de 2 horas e 24 minutos e é o que as tabelas tradicionais pressupõem. A resposta é `{yamas, birth panchpakshi}`. `yamas` tem `daytime` e `nighttime`, cada um deles uma lista de cinco timestamps locais `{start, end}` no formato 'YYYY-MM-DD HH:MM:SS'. `birth panchpakshi` é uma única string, uma de Vulture, Owl, Crow, Cock ou Peacock, derivada do grupo do nakshatra da Lua naquele instante, junto com o paksha: o mesmo grupo de nakshatras produz uma ave diferente nas quinzenas crescente e minguante, exceto o grupo do meio, que dá Crow em ambas.
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| datetime | string (date-time) | obrigatório | O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC. Equivale a date_time, nome que outros endpoints usam para o mesmo valor. |
| fixed | boolean | obrigatório | |
| 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. min -90 · max 90 |
| 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. min -180 · max 180 |
| 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. min -12 · max 14 |
| nakshatras | string | opcional | specialPARÂMETRO MORTO na camada HTTP - PanchpakshiView chama get_birth_panchpakshi(date_time=... apenas. No motor, o único valor com significado é o literal 'special', que seleciona a tabela nakshatras_special, de 28 entradas, em vez da tabela padrão, de 27 entradas. |