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

Trânsito pela casa

Leituras pré-escritas para um planeta em trânsito por uma determinada casa do mapa natal: o que se atribui à passagem do Sol pela terceira casa, à de Saturno pela sétima, e assim por diante, para nove planetas em doze casas. Uma consulta pura — informe `planet` e `house` e receba o texto. Não há data, hora nem local envolvidos, então combine-a com um cálculo que informe qual casa cada planeta ocupa no momento. Use-a junto com `/api/astro/planet_transit_natal_planets/`, que cobre a outra metade de um relatório de trânsitos: o contato de um planeta em trânsito com um planeta natal, e não com uma casa.

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

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
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.
planet	string	obrigatório	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Correspondência exata em minúsculas. Um valor desconhecido retorna "Invalid key: <x>" com HTTP 200. (O campo complementar `house` é um índice inteiro em uma lista, baseado em 0 - veja o exemplo __main__ em.

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_planet_transit_over_house	planet, house	A leitura para `planet` transitando pela casa indicada em `house`. Retorna uma lista de frases curtas, geralmente de duas a quatro, cada uma com uma afirmação independente sobre essa passagem.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/planet_transit_over_house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_planet_transit_over_house"],"planet":"Sun","house":3}'

Resposta

{
  "data": {
    "get_planet_transit_over_house": [
      "Irritable temper",
      "Gains physical strength, fame, and honour"
    ]
  },
  "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.