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

Trânsito sobre planeta natal

Leituras pré-escritas para um planeta passando sobre a posição natal de outro planeta — Saturno em trânsito sobre a Lua natal, Júpiter em trânsito sobre o Sol natal, e assim por diante. É a tabela de trânsitos planeta a planeta em que se baseia a maioria dos relatórios de trânsito. É uma consulta pura, sem nenhum cálculo de mapa por trás: informe o planeta em trânsito como `planet` e o planeta do mapa natal como `natal_planet` e receba o texto. Primeiro, descubra quais contatos estão de fato ativos com um cálculo de trânsito como `/api/astro/transit/` e depois chame este endpoint para obter o texto. Os dois argumentos aceitam os nove corpos, mas Vênus não está disponível como planeta em trânsito. A ordem importa: Saturno sobre o Sol natal é uma entrada diferente do Sol sobre Saturno natal.

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

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.
natal_planet	string	obrigatório	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Correspondência exata em minúsculas. Todos os 9 estão presentes sob cada planeta em trânsito (verificado com o parse do mapeamento via AST). Um valor desconhecido retorna "Invalid key: <x>" com HTTP 200.
planet	string	obrigatório	`sunmoonmarsmercuryjupitersaturnrahuketu` NOTA: 'venus' está AUSENTE como planeta em trânsito - o mapeamento tem apenas estas 8 chaves de nível superior. Um valor desconhecido retorna "Invalid key: <x>" com HTTP 200.

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_natal_planets	planet, natal_planet	A leitura para `planet` transitando sobre a posição natal de `natal_planet`. Retorna uma lista de frases curtas, geralmente de duas a quatro, cada uma com uma afirmação independente sobre o contato. O par tem direção, então o planeta em trânsito e o planeta natal não são intercambiáveis.

Exemplo de requisição

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

Resposta

{
  "data": {
    "get_planet_transit_natal_planets": [
      "Start of a new solar cycle",
      "Brings new energy, optimism, and enthusiasm"
    ]
  },
  "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.