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