POSThttps://api.occultapi.com/api/astro/planet_insights/

Leituras de posicionamento planetário

Corpo da requisiçãoJSON

Cole uma chave de API acima para enviar.

Trecho de código

curl -X POST https://api.occultapi.com/api/astro/planet_insights/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_planet_sign_insight"],"planet":"Jupiter","sign":"aries","house":0,"nakshatra":"rohini"}'

Interpretações pré-escritas para um único planeta em uma única posição. Informe um planeta e onde ele está — um signo do zodíaco, uma casa ou um nakshatra — e o endpoint retorna a leitura clássica dessa combinação. É uma consulta a um corpus de textos, não um cálculo: não há data, hora nem local envolvidos, e a mesma requisição sempre retorna o mesmo texto. Use-o para gerar os textos de um mapa que você já calculou. Pegue o signo, a casa e o nakshatra de Júpiter em `/api/astro/chart/` e depois chame este endpoint para obter o texto. As três chaves podem ser pedidas em uma única chamada, mas cada uma tem seu próprio parâmetro extra, então `planet`, `sign`, `house` e `nakshatra` precisam estar todos no corpo da requisição quando você pedir as três. A cobertura é de nove planetas (os sete mais Rahu e Ketu) em doze signos e doze casas. As leituras por nakshatra existem apenas para os sete planetas clássicos — Rahu e Ketu não têm nenhuma. Um planeta, signo, casa ou nakshatra não reconhecido volta como uma string explicativa com HTTP 200, e não como erro, então verifique o tipo que você recebeu antes de renderizá-lo.

Campos da requisição

Campo	Tipo	Obrigatório	Observações
house	integer	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.
nakshatra	string	obrigatório	`ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguni` A lista acima é a usada por jupiter, mercury, venus e saturn. 'rahu' e 'ketu' não têm nenhum dado de nakshatra. Valores sem correspondência retornam "Invalid nakshatra: <x> for planet <p>" com HTTP 200.
planet	string	obrigatório	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Um planeta desconhecido retorna a string "Invalid planet: <x>" com HTTP 200, não um status de erro. Observe que rahu e ketu NÃO têm dados de nakshatra (insights['rahu']['nakshatras'] é None), então get_planet_nakshatra_insight retorna "No nakshatra data available for rahu".
sign	string	obrigatório	`ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspisces` BUG NOS DADOS que vale a pena documentar: para planet='sun', a chave está grafada incorretamente como 'vigro' em vez de 'virgo', então sun+virgo retorna "Invalid sign: virgo for planet sun", enquanto sun+vigro funciona. Todos os outros oito planetas usam 'virgo'.

Chaves disponíveis (3)

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_planet_house_insight	planet, house	A leitura para `planet` posicionado em uma casa, sendo `house` de 1 a 12. Retorna um objeto com o rótulo da casa, um resumo e listas de características, além de `classicalTexts` — uma lista de `{heading, text}` que cita Parashara, Brihat Jataka, Saravali e Phaladipika sobre esse posicionamento — e `houseLordVariations`, uma lista de `{ascendent, aspect, result}` que mostra como a leitura muda para cada um dos doze ascendentes. Alguns dos campos de resumo e de características são null quando existem apenas as citações clássicas.
get_planet_nakshatra_insight	planet, nakshatra	A leitura para `planet` posicionado em `nakshatra`, retornada como uma ou duas frases de texto simples em vez de um objeto estruturado. Disponível para os sete planetas clássicos em todos os 27 nakshatras; Rahu e Ketu não têm leituras por nakshatra e, em vez disso, retornam uma string explicativa.
get_planet_sign_insight	planet, sign	A leitura para `planet` posicionado em `sign`. Retorna um objeto com `sign` (o rótulo em sânscrito para a combinação, como "Mesa Brhaspati"), um parágrafo `summary` e as listas `core traits`, `psychologicalPhysicalTraits`, `astrologicalReasoning` e `drstiphala`, esta última abrangendo os efeitos dos aspectos desse planeta a partir dali. Observe o espaço no nome do campo `core traits`.

Referência completa deste endpoint