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

Tránsito sobre un planeta natal

Lecturas ya redactadas para un planeta que pasa sobre la posición natal de otro: Saturno en tránsito sobre la Luna natal, Júpiter en tránsito sobre el Sol natal, etc. Es la tabla de tránsitos por pares con la que se construyen la mayoría de los informes de tránsitos. Es solo una consulta, sin ningún cálculo de carta detrás: indica el planeta en tránsito en `planet` y el planeta de la carta natal en `natal_planet` y obtendrás el texto. Averigua primero qué contactos están activos de verdad con un cálculo de tránsitos como `/api/astro/transit/` y luego llama a este endpoint para obtener el texto. Los dos argumentos aceptan los nueve cuerpos, aunque en el lado del tránsito falta Venus. El orden importa: Saturno sobre el Sol natal es una entrada distinta del Sol sobre Saturno natal.

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

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
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.
natal_planet	string	obligatorio	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Coincidencia exacta en minúsculas. Los 9 están presentes bajo cada planeta en tránsito (verificado analizando el mapeo con AST). Un valor desconocido devuelve "Invalid key: <x>" con HTTP 200.
planet	string	obligatorio	`sunmoonmarsmercuryjupitersaturnrahuketu` NOTA: 'venus' FALTA como planeta en tránsito: el mapeo solo tiene estas 8 claves de nivel superior. Un valor desconocido devuelve "Invalid key: <x>" con HTTP 200.

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_natal_planets	planet, natal_planet	La lectura de `planet` en tránsito sobre la posición natal de `natal_planet`. Devuelve una lista de frases cortas, normalmente de dos a cuatro, cada una con una afirmación independiente sobre el contacto. El par tiene sentido: el planeta en tránsito y el planeta natal no son intercambiables.

Ejemplo de solicitud

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

Respuesta

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

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.