Carregando o Playground
curl -X POST https://api.occultapi.com/api/astro/dosha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'Um dosha é uma aflição específica em um mapa natal — uma configuração planetária com nome próprio que os textos clássicos tratam como um fator de risco, quase sempre para casamento, saúde ou a linhagem ancestral. Este endpoint testa oito deles a partir do momento e do local do nascimento e pode retornar tanto os resultados brutos quanto explicações escritas prontas para exibição. Há duas formas de usá-lo. As chaves individuais (`kala_sarpa`, `manglik`, `pitru_dosha` e as demais) retornam resultados estruturados que você pode tratar no código. `get_dosha_details` retorna o conjunto inteiro como parágrafos HTML formatados, indexados pelo nome do dosha em inglês — ideal se você estiver renderizando um relatório; abrange Kala Sarpa, Manglik, Pitru, Guru Chandala, Kalathra, Ghata e Shrapit, mas não Ganda Moola. `get_dosha_resources` fornece o corpus de texto subjacente, caso você prefira montar o seu próprio texto. O serializador exige todos os campos booleanos e estruturados da requisição, mesmo para chaves que os ignoram. `manglik_reference_planet` é um índice de planeta (0 Sol, 1 Lua, 2 Marte, 3 Mercúrio, 4 Júpiter, 5 Vênus, 6 Saturno, 7 Rahu, 8 Ketu); o padrão do próprio motor, que mede a partir do ascendente, não pode ser selecionado pela API, porque o campo é tipado como inteiro. Neste endpoint, o campo de deslocamento UTC se chama `timezone`, e não `timezone_as_float`.
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| apply_exceptions | boolean | obrigatório | |
| 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). |
| include_2nd_house | boolean | obrigatório | |
| include_lagna_house | boolean | obrigatório | |
| 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. get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_detailsArray de strings. 'manglik' requer manglik_reference_planet, include_lagna_house, include_2nd_house e apply_exceptions; 'ganda_moola' requer moon_star; 'get_dosha_details' requer date_time e geopos. |
| 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 |
| manglik_reference_planet | integer | obrigatório | |
| moon_star | string | obrigatório | Semanticamente, um NÚMERO de nakshatra no intervalo 1-27 (os nakshatras Ganda Moola são 1 Ashwini, 9 Ashlesha, 10 Magha, 18 Jyeshtha, 19 Moola, 27 Revati). Não é possível publicar uma lista funcional de valores aceitos enquanto essa incompatibilidade de tipos não for corrigida. |
| timezone | number (double) | obrigatório | Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30). Equivale a timezone_as_float, nome que outros endpoints usam para o mesmo valor. |
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 | |
|---|---|---|---|
| ganda_moola | moon_star | Ganda Moola: indica se a estrela de nascimento é um dos seis nakshatras de junção (Ashwini, Ashlesha, Magha, Jyeshtha, Moola, Revati). A ideia é receber o número do nakshatra, de 1–27, em `moon_star` e retornar um booleano, mas o campo é tipado como string, enquanto a lista de comparação contém inteiros; por isso, do jeito que está, a chave retorna false para qualquer entrada. | |
| get_dosha_details | date_time, geopos | Todos os sete doshas narrativos, avaliados e redigidos de uma só vez: um objeto indexado pelo nome do dosha em inglês — Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha e Shrapit Dosha —, cujos valores são fragmentos HTML que dizem se o dosha está presente e o que ele significa. O Ganda Moola não está incluído. Requer `date_time` e o local. | |
| get_dosha_resources | — | O corpus completo dos textos explicativos dos doshas, como um objeto indexado pelo nome do dosha ('kala_sarpa', 'manglik', 'pitru', 'ghata' e assim por diante), com uma lista de parágrafos em inglês em cada um. A primeira entrada de cada lista é o texto para quando o dosha não existe, e as seguintes correspondem à casa ou à variedade envolvida. Use-o para montar o seu próprio texto em vez do HTML pronto. | |
| ghata | — | Ghata Dosha: Marte e Saturno juntos no mesmo signo. Retorna um único booleano. | |
| guru_chandala_dosha | — | Guru Chandala: Júpiter em conjunção com Rahu ou Ketu no mesmo signo. Retorna uma lista de dois elementos [se a combinação está presente, se Júpiter é o mais forte dos dois]. Ambos são false quando não há conjunção. | |
| kala_sarpa | — | Kala Sarpa Dosha: true quando todos os sete planetas clássicos estão cercados entre Rahu e Ketu, de um mesmo lado do eixo nodal. Retorna um único booleano; a variedade (Ananta, Kulika, Vasuki e assim por diante) decorre da casa que Rahu ocupa. | |
| kalathra | — | Kalathra Dosha, a aflição da casa do casamento. É true quando todos os maléficos naturais — Sol, Marte, Saturno, Rahu e Ketu — caem na 1ª, na 2ª, na 4ª, na 7ª, na 8ª ou na 12ª, contando a partir da sétima casa. Retorna um único booleano e, como exige que os cinco maléficos atendam à condição, raramente é true. | |
| manglik | manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions | Manglik, ou Mangal Dosha: se Marte cai em uma das casas que afligem o casamento, contadas a partir de `manglik_reference_planet`. Retorna uma lista de três elementos [se é manglik, se um cancelamento se aplica, os números das regras de cancelamento satisfeitas]. As casas testadas são a 4ª, a 7ª, a 8ª e a 12ª, mais a 2ª quando `include_2nd_house` é true e a 1ª quando `include_lagna_house` é true; os cancelamentos só são avaliados quando `apply_exceptions` é true. | |
| pitru_dosha | — | Pitru Dosha, a aflição da linhagem ancestral. Retorna uma lista de dois elementos [true ou false, os números das regras que foram acionadas]. Cinco regras são testadas, nesta ordem: um luminar ou Rahu na 9ª, Ketu na 4ª, Sol/Lua/Rahu/Ketu aflitos por Marte ou Saturno, uma aglomeração de Mercúrio, Vênus e Rahu na 2ª, na 5ª, na 9ª ou na 12ª, e o Sol ou a Lua em conjunção com um nodo. | |
| shrapit | — | Shrapit Dosha: Saturno e Rahu juntos no mesmo signo. Retorna um único booleano. |