POST/api/panchpakshi/1 crédito

Pancha Pakshi (dia em dez yamas)

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.

https://api.occultapi.com/api/panchpakshi/

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos da requisição

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	`special` PARÂ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.

Exemplo de requisição

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}'

Resposta

{
  "data": {
    "yamas": {
      "daytime": [
        {
          "start": "2024-11-21 06:00:00",
          "end": "2024-11-21 08:24:00"
        },
        {
          "start": "2024-11-21 08:24:00",
          "end": "2024-11-21 10:48:00"
        },
        {
          "start": "2024-11-21 10:48:00",
          "end": "2024-11-21 13:12:00"
        },
        {
          "start": "2024-11-21 13:12:00",
          "end": "2024-11-21 15:36:00"
        },
        {
          "start": "2024-11-21 15:36:00",
          "end": "2024-11-21 18:00:00"
        }
      ],
      "nighttime": [
        {
          "start": "2024-11-21 18:00:00",
          "end": "2024-11-21 20:24:00"
        },
        {
          "start": "2024-11-21 20:24:00",
          "end": "2024-11-21 22:48:00"
        },
        {
          "start": "2024-11-21 22:48:00",
          "end": "2024-11-22 01:12:00"
        },
        {
          "start": "2024-11-22 01:12:00",
          "end": "2024-11-22 03:36:00"
        },
        {
          "start": "2024-11-22 03:36:00",
          "end": "2024-11-22 06:00:00"
        }
      ]
    },
    "birth panchpakshi": "Cock"
  },
  "message": "successful",
  "is_error": false
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.