POST/api/astro/dasha/nakshatra/1 crédito

Dasha nakshatra (qualquer sistema)

Qualquer um dos onze dashas nakshatra, pelo nome. Os sistemas mais procurados têm endpoints próprios; este cobre os demais — Chaturaseeti Sama, Dwadashottari, Dwisaptati, Panchottari, Sataabdika, Shattrimsa Sama e Budhi Gati — sem precisar de uma rota para cada um. Aceita tanto o nome de exibição quanto o id do motor. Todos eles, exceto o Vimshottari e o Yogini, são condicionais; veja /api/astro/dasha_applicability/.

https://api.occultapi.com/api/astro/dasha/nakshatra/

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
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
system	string	obrigatório	Sistema de dasha. A lista está em /api/astro/dasha/systems/; são aceitos tanto o nome de exibição quanto o id do motor.
dasha_direction	string	opcional	`forwardbackward`
dasha_start	string	opcional	Ciclo em que a linha do tempo começa. `currentnextprevious`
date_time	string (date-time)	opcional	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.
datetime	string (date-time)	opcional	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.
days_in_year	number (double)	opcional	Duração do ano usada para medir os períodos. 360 para o ano savana clássico, 365.25 para o ano juliano. min 360 · max 365.256364
levels	integer	opcional	Profundidade de aninhamento: 1 só mahadasha, 2 acrescenta antardasha, 3 acrescenta pratyantardasha. O limite é 4 porque a resposta cresce cerca de dez vezes a cada nível. min 1 · max 4
node	string	opcional	Modelo do nodo lunar. Obrigatório no endpoint pai de rashi, que não define um padrão; aqui, há um padrão. `truemean`
timezone_as_float	number (double)	opcional	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

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/dasha/nakshatra/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"levels":2,"system":"Dwisaptati"}'

Resposta

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"system\": \"Dwisaptati\", \"engine_id\": \"DwisaptatiDasha\", \"family\": \"nakshatra\", \"lord_type\": \"planet\", \"levels\": 2, \"level_names\": [\"mahadasha\", \"antardasha\"], \"cycle_years\": 72, \"conditional\": true, \"periods\": [{\"lord\": \"jupiter\", \"start\": \"1984-08-04 13:36:41.045503+00:00\", \"end\": \"1993-08-04 19:36:41.045503+00:00\", \"children\": [{\"lord\": \"jupiter\", \"start\": \"1984-08-04 13:36:41.045503+00:00\", \"end\": \"1985-09-19 10:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"venus\", \"start\": \"1985-09-19 10:36:41.045503+00:00\", \"end\": \"1986-11-04 07:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"saturn\", \"start\": \"1986-11-04 07:36:41.045503+00:00\", \"end\": \"1987-12-20 04:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"rahu\", \"start\": \"1987-12-20 04:36:41.045503+00:00\", \"end\": \"1989-02-03 01:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"1989-02-03 01:36:41.045503+00:00\", \"end\": \"1990-03-20 22:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"moon\", \"start\": \"1990-03-20 22:36:41.045503+00:00\", \"end\": \"1991-05-05 19:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"mars\", \"start\": \"1991-05-05 19:36:41.045503+00:00\", \"end\": \"1992-06-19 16:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"mercury\", \"start\": \"1992-06-19 16:36:41.045503+00:00\", \"end\": \"1993-08-04 13:36:41.045503+00:00\", \"children\": []}]}, {\"lord\": \"venus\", \"start\": \"1993-08-04 19:36:41.045503+00:00\", \"end\": \"2002-08-05 01:36:41.045503+00:00\", \"children\": [{\"lord\": \"venus\", \"start\": \"1993-08-04 19:36:41.045503+00:00\", \"end\": \"1994-09-19 16:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"saturn\", \"start\": \"1994-09-19 16:36:41.045503+00:00\", \"end\": \"1995-11-04 13:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"rahu\", \"start\": \"1995-11-04 13:36:41.045503+00:00\", \"end\": \"1996-12-19 10:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"1996-12-19 10:36:41.045503+00:00\", \"end\": \"1998-02-03 07:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"moon\", \"start\": \"1998-02-03 07:36:41.045503+00:00\", \"end\": \"1999-03-21 04:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"mars\", \"start\": \"1999-03-21 04:36:41.045503+00:00\", \"end\": \"2000-05-05 01:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"mercury\", \"start\": \"2000-05-05 01:36:41.045503+00:00\", \"end\": \"2001-06-19 22:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"jupiter\", \"start\": \"2001-06-19 22:36:41.045503+00:00\", \"end\": \"2002-08-04 19:36:41.045503+00:00\", \"children\": []}]}, {\"lord\": \"saturn\", \"start\": \"2002-08-05 01:36:41.045503+00:00\", \"end\": \"2011-08-05 07:36:41.045503+00:00\", \"children\": [{\"lord\": \"saturn\", \"start\": \"2002-08-05 01:36:41.045503+00:00\", \"end\": \"2003-09-19 22:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"rahu\", \"start\": \"2003-09-19 22:36:41.045503+00:00\", \"end\": \"2004-11-03 19:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"2004-11-03 19:36:41.045503+00:00\", \"end\": \"2005-12-19 16:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"moon\", \"start\": \"2005-12-19 16:36:41.045503+00:00\", \"end\": \"2007-02-03 13:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"mars\", \"start\": \"2007-02-03 13:36:41.045503+00:00\", \"end\": \"2008-03-20 10:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"mercury\", \"start\": \"2008-03-20 10:36:41.045503+00:00\", \"end\": \"2009-05-05 07:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"jupiter\", \"start\": \"2009-05-05 07:36:41.045503+00:00\", \"end\": \"2010-06-20 04:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"venus\", \"start\": \"2010-06-20 04:36:41.045503+00:00\", \"end\": \"2011-08-05 01:36:41.045503+00:00\", \"children\": []}]}, {\"lord\": \"rahu\", \"start\": \"2011-08-05 07:36:41.045503+00:00\", \"end\": \"2020-08-04 13:36:41.045503+00:00\", \"children\": [{\"lord\": \"rahu\", \"start\": \"2011-08-05 07:36:41.045503+00:00\", \"end\": \"2012-09-19 04:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"2012-09-19 04:36:41.045503+00:00\", \"end\": \"2013-11-04 01:36:41.045503+00:00\", \"children\": []}, {\"lord\": \"moon\", \"start\": \"2013-11-04 01:36:41.045503+00:00\", \"end\": \"2014-12-19 22:36:41.045503+00:"
}

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.