/api/astro/raja_yoga/1 créditoRaja yogas
Um raja yoga é uma combinação no mapa natal que, segundo a tradição, traz status e sucesso. O caso central é uma associação entre o senhor de uma casa angular (1, 4, 7, 10) e o senhor de um trígono (1, 5, 9): os dois em conjunção, em aspecto mútuo ou em troca de signos. Este endpoint verifica as três variantes com nome próprio que o motor implementa: Vipareeta raja yoga (os senhores das casas difíceis — sexta, oitava e décima segunda — posicionados nessas mesmas casas), Neecha Bhanga raja yoga (um planeta debilitado cuja debilitação é cancelada) e Dharma-Karmadhipati raja yoga (os senhores da nona e da décima casas em associação). Há uma única chave, `get_raja_yoga_details_for_all_charts`, que faz as verificações em todos os mapas divisionais que o motor conhece, e não só no mapa natal. O valor é um array de três elementos: um objeto que associa cada yoga encontrado aos seus detalhes, o número de yogas encontrados e o número de verificações feitas — três tipos de yoga em vinte e três mapas divisionais, ou seja, 69. Cada entrada de detalhe é uma lista de strings: primeiro, uma linha com o mapa divisional e os pares de planetas responsáveis, como `"D1-Raja Yoga Pairs: [Viyaazhan-Sani]"`; depois, o nome do yoga, sua definição e seus efeitos previstos. Duas observações para interpretar a saída. Na linha de pares, os nomes dos planetas vêm sempre em transliteração tâmil, independentemente do que mais você enviar: Suriyan é o Sol, Chandran a Lua, Sevvay Marte, Budhan Mercúrio, Viyaazhan Júpiter, VeLLi Vênus e Sani Saturno. Além disso, como os resultados de todos os mapas divisionais são mesclados em um único objeto indexado pelo nome do yoga, cada yoga aparece uma única vez, atribuído ao primeiro mapa divisional em que foi encontrado — um prefixo `D4-` significa que o próprio mapa natal não tinha esse yoga. Uma ressalva antes de usar isto como base: no momento, o cálculo subjacente substitui o `date_time` enviado por uma data fixa, então o resultado reage aos campos de localização, mas não à data de nascimento. Compare com um mapa que você conheça antes de confiar no resultado.
https://api.occultapi.com/api/astro/raja_yoga/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/jsonCampos 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. |
| 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. |
| 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 | 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. |
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 |
|---|---|---|
| get_raja_yoga_details_for_all_charts | — | Varre todos os mapas divisionais em busca das três variantes de raja yoga que o motor implementa — Vipareeta, Neecha Bhanga e Dharma-Karmadhipati. Retorna um array de três elementos: um objeto indexado pelo nome do yoga com os detalhes desse yoga, a contagem de yogas encontrados e o número de verificações feitas (69, ou seja, três tipos de yoga em vinte e três mapas). Cada valor de detalhe é uma lista de strings — o mapa divisional e os pares de planetas responsáveis, depois o nome, a definição e os efeitos do yoga — e, como os resultados dos mapas são mesclados em um único objeto, um yoga aparece apenas uma vez, atribuído ao primeiro mapa em que foi encontrado. |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/raja_yoga/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_raja_yoga_details_for_all_charts"],"date_time":"2025-07-14T11:00:37.673Z","latitude":13,"longitude":77.5946,"timezone":5.5}'Resposta
{
"data": {
"get_raja_yoga_details_for_all_charts": [
{
"vipareetha_raja_yoga": [
"D1-Raja Yoga Pairs: [Viyaazhan-Sani] [Viyaazhan-VeLLi] ",
"Vipareetha Raja yoga",
"The 6th, 8th and 12th houses are known as trik sthanas or dusthanas (bad houses). If their lords occupies dusthanas or conjoin dusthanas, it results in this yoga.",
"One having this yoga experiences tremedous success, typically after an initial struggle. Vipareeta means extreme."
],
"neecha_bhanga_raja_yoga": [
"D4-Raja Yoga Pairs: [Sevvay-Sani] [Sevvay-VeLLi] ",
"Neecha Bhanga Raja yoga",
"1. If the lord of the sign occupied by a weak or debilitated planet is exalted or is in Kendra from Moon. Ex, If Jupiter is debilitated in Capricorn and if Saturn is exalted and placed in Kendra from moon. 2. If the debilitated planet is conjunct with the Exalted Planet. 3. If the debilitated planet is aspected by the master of that sign. Ex, If Sun is debilitated in Libra and it is aspect by Venus with 7th aspect. 4. If the debilitated planet is Exalted in Navamsa Chart. 5. The planet which gets exalted in the sign where a debilitated planet is placed is in a Kendra from the Lagna or the Moon. Ex, If Sun is debilitated in the birth chart in Libra and Saturn which gets exalted in Libra is placed in Kendra from Lagna or Moon. NOTE: Checks only the first 3 conditions below. 4 and 5 to be done in future version",
"Neecha Bhanga Raja Yoga provides one with Fame, Property, and Control usually. But all the said prosperities will be used by the native only in the next half of life particularly after the age 36 corresponding to the age at the yoga developing dasha, sub-period and transits take place in one’s chart. This typical nature is attributed to this Yoga because the planet who create Neecha Bhanga Rajayoga is subjected to debilitation first and then attains the cancellation. Likewise, the native's life too would suffer adversities in the initial part of life and then will start excelling. Earning from multiple sources and earning a good reputation from a vast number of peoples and various communities along with holding a good image is the result of this Yoga. One will be admired within his/her personal, professional and social circles. Whatever they do brings a good reputation for them and people usually like them for what they are. They will gather huge property and start producing many sources of income once the Rajayoga is in operation. They will also hold power in life. The native will be holding power over many people once this Yoga is operational."
],
"dharma_karmadhipati_raja_yoga": [
"D1-Raja Yoga Pairs: [Viyaazhan-Sani] ",
"Dharma Karmadhipati Raja yoga",
"If the lords of dharma sthana (9th) and karma sthana (10th) form a raja yoga, it is known by this special name. The 9th house is the most important trine and the 10th house is the most important quadrant.",
"One born with this yoga is sincere, devoted and righteous. He is fortunate."
]
},
3,
69
]
},
"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.