API de dignidades esenciales
Las dignidades esenciales miden con qué comodidad se sitúa cada planeta en el signo y el grado que ocupa. Este endpoint pasa cada cuerpo por el esquema tradicional quíntuple —regencia, exaltación, triplicidad, término y faz— junto con las dos debilidades, y devuelve tanto un desglose por planeta como un único total ponderado.
API de dignidades esenciales
Dado un momento y un lugar de nacimiento, el endpoint localiza cada planeta por signo y grado, y luego lo puntúa frente a las tablas de dignidades ptolemaicas que la práctica medieval y helenística heredó. Comprueba las cinco dignidades esenciales en orden descendente de fuerza —regencia por domicilio, exaltación, regencia por triplicidad para la secta de la carta, el término o límite en que cae el grado, y la faz o decanato— y las dos debilidades esenciales, caída y exilio, donde un planeta se sitúa opuesto a su regencia o exaltación. Cada planeta recibe los puntos de dignidad convencionales por cada condición que cumple, las debilidades restan, y las cifras se acumulan en un desglose por cuerpo bajo data.dignities más un totalScore para toda la carta. El resultado te dice no solo en qué signo está un planeta, sino cuán dignificado o debilitado está allí, distinguiendo un planeta en su propio hogar de uno que solo pasa por un signo sobre el que no tiene reclamo.
POST/v1/essential-dignities
curl -X POST https://api.astroway.info/v1/essential-dignities \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52
}'{
"ok": true,
"data": {
"dignities": [
{
"planet": "Venus",
"rulership": false,
"exaltation": true,
"triplicity": true,
"score": 7
}
],
"totalScore": 12
}
}Parámetros
| name | type | Obligatorio | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sí | Birth date. |
| time | string (HH:MM:SS) | sí | Local clock time at birth. |
| timezoneOffset | number (hours) | sí | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | sí | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | sí | Birth-place longitude, decimal degrees (east positive). |
Cuándo usarlo
Recurre a este endpoint siempre que una interpretación necesite ponderar la fuerza planetaria en lugar de solo reportar posiciones: lectores de cartas tradicionales y helenísticos, auxiliares de horaria, puntuación electiva, o cualquier herramienta que clasifique qué planetas realmente sostienen una carta. La puntuación total te da un escalar rápido para ordenar o aplicar umbrales, mientras que las filas por planeta te permiten explicar por qué: este Venus está exaltado y en triplicidad, ese Marte está en caída y exilio. Se combina de forma natural con el endpoint natal-chart: toma las posiciones de signo y grado de allí y pasa los mismos datos de nacimiento aquí para superponer la ponderación de dignidades. Como el esquema es basado en reglas y determinista, la misma entrada siempre arroja las mismas puntuaciones, lo que lo hace fiable para funcionalidades de comparación que clasifican una carta frente a otra.
Notas
La puntuación sigue la tabla de dignidades ptolemaica tal como se transmitió en la astrología occidental tradicional y medieval; la regencia por triplicidad se asigna según la secta de la carta (diurna o nocturna). Las posiciones planetarias provienen del motor WASM de Swiss Ephemeris (Astrodienst) en el zodíaco tropical, de modo que el signo y el grado sobre los que descansan las dignidades coinciden exactamente con los endpoints natales.
Prueba la API de Dignidades esenciales
Consigue una clave y haz tu primera llamada en menos de un minuto.