Cargando el Playground
curl -X POST https://api.occultapi.com/api/astro/traditional/dignities/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Domicilio, exaltación, triplicidad, término y faz de cada planeta, con la puntuación de Lilly. La columna vertebral de la astrología occidental tradicional y lo que decide si un planeta está en condiciones de actuar. Para cada planeta: cuáles de las cinco dignidades tiene donde está, qué debilidades y el total ponderado: domicilio +5, exaltación +4, triplicidad +3, término +2, faz +1, frente a exilio -5, caída -4 y peregrino -5. TROPICAL, necesariamente. La dignidad esencial se define respecto al zodíaco tropical. Todos los demás endpoints de cartas de esta API son siderales, y leer estas tablas con longitudes siderales retrasaría casi todos los planetas un signo y mostraría como peregrino a un planeta en su propio domicilio. La triplicidad depende de la SECTA, así que primero se calcula la secta a partir de la altura real del Sol y se devuelve junto al resultado: los regentes diurno y nocturno de un elemento son planetas distintos, y una tabla aplicada con el equivocado da un resultado erróneo sin que nada en la salida lo delate. Los términos son los egipcios y las faces siguen el orden caldeo. Las fuentes discrepan (los términos de Ptolomeo difieren de los egipcios), así que la elección se indica en `tables_used` en lugar de dejar que se deduzca de números que no coincidirán con tu libro. La condición de peregrino solo se aplica cuando un planeta no tiene ninguna dignidad y no está ni en exilio ni en caída, de modo que nunca se penaliza dos veces una misma posición. Urano, Neptuno y Plutón no rigen nada en esta doctrina y se devuelven con una puntuación null en lugar de un cero que parecería una medición.
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| date_time | string (date-time) | obligatorio | El momento del cálculo, en ISO 8601. Incluye SIEMPRE la diferencia con UTC o una Z final: un valor sin zona horaria se interpreta como Asia/Kolkata (UTC+05:30), no como UTC, y puede devolver con un 200 el resultado del día anterior. '2026-09-01T06:00:00Z' y '2026-09-01 06:00:00' son instantes distintos y dan respuestas distintas. |
| latitude | number (double) | obligatorio | Latitud del lugar, en grados decimales. Los valores positivos indican el norte y los negativos, el sur. Ejemplo: 26.9124 para Jaipur, 40.7128 para Nueva York. No se aceptan minutos ni segundos: conviértelos antes. min -89.9 · max 89.9 |
| longitude | number (double) | obligatorio | Longitud del lugar, en grados decimales. Los valores positivos indican el este y los negativos, el oeste. Ejemplo: 75.7873 para Jaipur, -74.0060 para Nueva York. Cuidado con el signo: si falta el menos, Nueva York acaba en China. min -180 · max 180 |
| timezone_as_float | number (double) | obligatorio | Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30), -5 para Nueva York en invierno, 5.75 para Nepal. NO se contrasta con date_time: si los dos no coinciden, recibes una respuesta correcta para un momento equivocado, así que toma ambos valores de la misma fuente. Usa la diferencia vigente en esa fecha, no la de hoy: para un nacimiento en verano en un país con horario de verano, hace falta la diferencia de verano. min -12 · max 14 |
| keys | array | opcional | 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. |