POST/api/astro/panchang_element_birth_effect/1 crédito

Efeitos do panchanga de nascimento (tabela de referência)

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.

https://api.occultapi.com/api/astro/panchang_element_birth_effect/

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
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	`suryachandramangalabudhabrihaspatishukrashani` Um 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	`bavabalavakaulavataitilagaravanijavishtishakunichatushpadanagakimstughna` Um 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	`shuklakrishna` Um 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	`pratipadadvitiyatritiyachaturthipanchamishashthisaptamiashtaminavamidashamiekadashidvadashi` Um 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	`sundaymondaytuesdaywednesdaythursdayfridaysaturday` Um 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	`vishkumbhapritiayushmansaubhagyashobhanaatigandasukarmadhritishulagandavriddhidhruva` Um 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.

Chaves disponíveis (13)

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.

Exemplo de requisição

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

Resposta

{
  "data": {
    "get_vaara_during_birth": "Individuals born on Sunday typically possess a steady and determined nature with a fearless approach to life. They often have a naturally authoritative disposition and demonstrate skillfulness in their endeavors. These individuals tend to be honorable and maintain high standards of purity in their conduct. They may have a tendency toward bilious temperament and often exhibit leadership qualities with a noble bearing."
  },
  "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.