curl -X POST https://api.occultapi.com/api/astro/panchang_element_birth_effect/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_vaara_during_birth"],"vaara":"sunday","hora":"surya","paksha":"shukla","tithi":"pratipada","karana":"bava","yoga":"vishkumbha"}'Os membros do panchanga — dia da semana, tithi, karana, yoga e quinzena, além da hora planetária — trazem, cada um, uma leitura clássica de caráter para quem nasce sob eles. Este endpoint é a tabela de consulta dessas leituras. É puro texto de referência: nada é calculado, e nenhuma data, hora ou local é enviado. Você determina o tithi de nascimento da pessoa, o dia da semana e assim por diante em outro lugar (a partir de /api/astro/panchanga/, por exemplo) e passa os nomes para obter o parágrafo correspondente a cada um. As seis chaves de consulta são get_vaara_during_birth, get_birth_tithi_effects, get_birth_karana_effects, get_birth_panchang_yoga_effects, get_birth_paksha_effects e get_birth_hora_result, cada uma recebendo um campo da requisição com o nome correspondente. Todo valor aceito é uma transliteração em minúsculas, e a grafia exata importa — 'shula', não 'shoola'; 'priti', não 'preeti' —, e a hora é identificada pelo nome sânscrito do planeta (surya, chandra, mangala…), e não pelo dia da semana. Os seis auxiliares get_all_*_keys retornam as listas aceitas, e get_all_keys_summary retorna as seis de uma vez; use um deles em vez de fixar o vocabulário no código. Um valor não reconhecido não gera erro: retorna HTTP 200 com uma string que lista as opções válidas.
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| 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. |
| hora | string | opcional | suryachandramangalabudhabrihaspatishukrashaniUm valor desconhecido retorna a string "Invalid hora: <x>. Available options: [...]" com HTTP 200 em vez de um status de erro; o endpoint também expõe uma chave complementar 'get_all_hora_keys' que retorna exatamente esta lista em tempo de execução. Atenção ao estilo de transliteração: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (não shoola/preeti/indra), e os valores de hora são os nomes sânscritos dos planetas (surya/chandra/mangala/budha/brihaspati/shukra/shani), não nomes de dias da semana ou de planetas em inglês. |
| karana | string | opcional | bavabalavakaulavataitilagaravanijavishtishakunichatushpadanagakimstughnaUm valor desconhecido retorna a string "Invalid karana: <x>. Available options: [...]" com HTTP 200 em vez de um status de erro; o endpoint também expõe uma chave complementar 'get_all_karana_keys' que retorna exatamente esta lista em tempo de execução. Atenção ao estilo de transliteração: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (não shoola/preeti/indra), e os valores de hora são os nomes sânscritos dos planetas (surya/chandra/mangala/budha/brihaspati/shukra/shani), não nomes de dias da semana ou de planetas em inglês. |
| paksha | string | opcional | shuklakrishnaUm valor desconhecido retorna a string "Invalid paksha: <x>. Available options: [...]" com HTTP 200 em vez de um status de erro; o endpoint também expõe uma chave complementar 'get_all_paksha_keys' que retorna exatamente esta lista em tempo de execução. Atenção ao estilo de transliteração: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (não shoola/preeti/indra), e os valores de hora são os nomes sânscritos dos planetas (surya/chandra/mangala/budha/brihaspati/shukra/shani), não nomes de dias da semana ou de planetas em inglês. |
| tithi | string | opcional | pratipadadvitiyatritiyachaturthipanchamishashthisaptamiashtaminavamidashamiekadashidvadashiUm valor desconhecido retorna a string "Invalid tithi: <x>. Available options: [...]" com HTTP 200 em vez de um status de erro; o endpoint também expõe uma chave complementar 'get_all_tithi_keys' que retorna exatamente esta lista em tempo de execução. Atenção ao estilo de transliteração: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (não shoola/preeti/indra), e os valores de hora são os nomes sânscritos dos planetas (surya/chandra/mangala/budha/brihaspati/shukra/shani), não nomes de dias da semana ou de planetas em inglês. |
| vaara | string | opcional | sundaymondaytuesdaywednesdaythursdayfridaysaturdayUm valor desconhecido retorna a string "Invalid vaara: <x>. Available options: [...]" com HTTP 200 em vez de um status de erro; o endpoint também expõe uma chave complementar 'get_all_vaara_keys' que retorna exatamente esta lista em tempo de execução. Atenção ao estilo de transliteração: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (não shoola/preeti/indra), e os valores de hora são os nomes sânscritos dos planetas (surya/chandra/mangala/budha/brihaspati/shukra/shani), não nomes de dias da semana ou de planetas em inglês. |
| yoga | string | opcional | vishkumbhapritiayushmansaubhagyashobhanaatigandasukarmadhritishulagandavriddhidhruvaUm valor desconhecido retorna a string "Invalid yoga: <x>. Available options: [...]" com HTTP 200 em vez de um status de erro; o endpoint também expõe uma chave complementar 'get_all_yoga_keys' que retorna exatamente esta lista em tempo de execução. Atenção ao estilo de transliteração: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (não shoola/preeti/indra), e os valores de hora são os nomes sânscritos dos planetas (surya/chandra/mangala/budha/brihaspati/shukra/shani), não nomes de dias da semana ou de planetas em inglês. |
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_all_hora_keys | — | Os sete nomes de hora que este endpoint aceita, como uma lista de nomes sânscritos de planetas em minúsculas. | |
| get_all_karana_keys | — | Os onze nomes de karana que este endpoint aceita, como uma lista de strings em minúsculas. | |
| get_all_keys_summary | — | Todos os valores aceitos para as seis categorias em um único objeto, com as chaves vaara_keys, hora_keys, paksha_keys, tithi_keys, karana_keys e yoga_keys. Uma chamada em vez de seis. | |
| get_all_paksha_keys | — | Os dois nomes de quinzena que este endpoint aceita, como uma lista de strings em minúsculas: shukla e krishna. | |
| get_all_tithi_keys | — | Os dezesseis nomes de tithi que este endpoint aceita, como uma lista de strings em minúsculas. Use-a para preencher uma lista de seleção em vez de fixar as grafias no código. | |
| get_all_vaara_keys | — | Os sete nomes de dia da semana que este endpoint aceita, como uma lista de nomes de dias em inglês, em minúsculas. | |
| get_all_yoga_keys | — | Os vinte e sete nomes de Nityayoga que este endpoint aceita, como uma lista de strings em minúsculas. | |
| get_birth_hora_result | hora | A leitura da hora planetária que rege o momento do nascimento. Recebe no campo hora um nome sânscrito de planeta em minúsculas — surya, chandra, mangala, budha, brihaspati, shukra, shani — e retorna um parágrafo curto de texto em inglês. | |
| get_birth_karana_effects | karana | A leitura do karana de nascimento. Recebe no campo karana um dos onze nomes em minúsculas (bava, balava, kaulava, taitila, gara, vanija, vishti, shakuni, chatushpada, naga, kimstughna) e retorna um parágrafo de texto em inglês. | |
| get_birth_paksha_effects | paksha | A leitura para quem nasce na quinzena clara ou na quinzena escura. Recebe no campo paksha 'shukla' ou 'krishna' e retorna um parágrafo de texto em inglês. | |
| get_birth_panchang_yoga_effects | yoga | A leitura do Nityayoga em vigor no nascimento. Recebe no campo yoga um dos vinte e sete nomes em minúsculas, de vishkumbha a vaidhriti, e retorna um parágrafo de texto em inglês. | |
| get_birth_tithi_effects | tithi | A leitura do tithi de nascimento. Recebe no campo tithi um de dezesseis nomes em minúsculas — de pratipada a chaturdashi, além de purnima e amavasya — e retorna um parágrafo de texto em inglês. Um mesmo nome cobre esse tithi em qualquer uma das quinzenas. | |
| get_vaara_during_birth | vaara | A leitura de caráter para quem nasce em determinado dia da semana. Recebe no campo vaara um nome de dia em inglês, em minúsculas, e retorna um parágrafo de texto em inglês. Um valor não reconhecido retorna uma string que lista as opções válidas, ainda com HTTP 200. |