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

Tránsito por una casa

Lecturas ya redactadas para un planeta que transita una casa concreta de la carta natal: lo que se dice que trae el paso del Sol por la casa tres, el de Saturno por la siete, etc., para nueve planetas en doce casas. Es solo una consulta: indica `planet` y `house` y obtendrás el texto. No intervienen fecha, hora ni lugar, así que combínalo con un cálculo que te diga qué casa ocupa ahora cada planeta. Úsalo junto con `/api/astro/planet_transit_natal_planets/`, que cubre la otra mitad de un informe de tránsitos: el contacto de un planeta en tránsito con un planeta natal, en lugar de con una casa.

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

Probar solicitud

Autenticación

Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos de la solicitud

Campo	Tipo	Obligatorio	Notas
house	integer	obligatorio
keys	array	obligatorio	Los cálculos que quieres recibir, como lista de nombres. Consulta la tabla de claves de este endpoint; un nombre que no se reconoce invalida toda la solicitud. Cada llamada cuesta un crédito, pidas las claves que pidas, así que pide todo lo que necesites de una vez en lugar de hacer varias llamadas.
planet	string	obligatorio	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Coincidencia exacta en minúsculas. Un valor desconocido devuelve "Invalid key: <x>" con HTTP 200. (El campo complementario `house` es un índice entero de una lista, con base 0; consulta el ejemplo de __main__.)

Claves disponibles (1)

Indica en keys exactamente los cálculos que quieres. Si una clave no existe, se rechaza toda la solicitud. Pidas las que pidas, se cobra 1 crédito, así que agrúpalas en una sola llamada.

Clave	Campos adicionales	Descripción
get_planet_transit_over_house	planet, house	La lectura de `planet` en tránsito por la casa que indica `house`. Devuelve una lista de frases cortas, normalmente de dos a cuatro, cada una con una afirmación independiente sobre ese paso.

Ejemplo de solicitud

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

Respuesta

{
  "data": {
    "get_planet_transit_over_house": [
      "Irritable temper",
      "Gains physical strength, fame, and honour"
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data, cada uno bajo la clave que pediste.

Errores

Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.