POST/api/astro/dasha_applicability/1 crédito

Aplicabilidade de dashas

A astrologia védica tem muitos sistemas de períodos planetários, e a maioria dos baseados em nakshatras, além do Vimshottari, é condicional: os textos clássicos mandam usar o Ashtottari só quando uma condição específica está presente no mapa, o Dwadashottari só quando outra está, e assim por diante. Escolher errado significa aplicar a linha do tempo errada à vida inteira de alguém. Este endpoint aplica essas condições por você. Ele monta os mapas Rashi, Navamsa e Dwadasamsa a partir dos dados de nascimento e testa seis sistemas condicionais — Ashtottari, Chaturaseeti Sama, Dwadashottari, Dwisaptati, Panchottari e Sataabdika —, cada um no mapa em que a tradição clássica o avalia. Envie o momento e o local do nascimento junto com `year_option` (a duração do ano, em dias, a usar), `start_option` e `direction_option`, que são as mesmas configurações de período que os endpoints de dasha recebem. Use o resultado para decidir qual endpoint de dasha chamar em seguida.

https://api.occultapi.com/api/astro/dasha_applicability/

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
date_time	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, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes. Restrição de FORMATO. DRF DateTimeField: apenas ISO-8601 (formatos de entrada padrão do DRF), por exemplo "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sem fuso horário = assume-se UTC).
direction_option	string	obrigatório	`forwardbackward` Diferencia maiúsculas de minúsculas; em minúsculas. Qualquer outro valor retorna 400 "Invalid direction: must be 'forward' or 'backward'".
keys	array	obrigatório	Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas. `applicability_check` Array de strings; existe apenas uma chave.
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
start_option	string	obrigatório	`currentnextprevious` Diferencia maiúsculas de minúsculas; em minúsculas. Qualquer outro valor retorna 400 "Invalid start value: must be 'current', 'next', or 'previous'". Comprimento máximo de 100 por.
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
year_option	number (double)	obrigatório	`365.256364365.24219365.25365360` min 360 · max 365.256364

Chaves disponíveis (1)

Liste em keys só os cálculos que você quer. Uma chave desconhecida faz a requisição inteira ser rejeitada. O custo é 1 crédito, não importa quantas chaves você peça — então agrupe tudo numa chamada só.

Chave	Campos extras exigidos	Descrição
applicability_check	—	Os sistemas de dasha nakshatra condicionais cujas condições clássicas de elegibilidade este mapa satisfaz, como uma lista de nomes de exibição escolhidos entre "Ashtottari Dasha", "Chaturaseeti Sama Dasha", "Dwadashottari Dasha", "Dwisaptati Dasha", "Panchottari Dasha" e "Sataabdika Dasha". Uma lista vazia significa que nenhum dos seis se aplica. O Vimshottari é incondicional e não está entre eles.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/dasha_applicability/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["applicability_check"],"date_time":"2025-03-27T09:52:50.441Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year_option":365.256364,"start_option":"current","direction_option":"forward"}'

Resposta

{
  "data": {
    "applicability_check": []
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data, sob cada chave que você pediu.

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.