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

Aplicabilidad de los dashas

La astrología védica tiene muchos sistemas de periodos planetarios, y casi todos los basados en nakshatras, aparte del Vimshottari, son condicionales: según los textos clásicos, el Ashtottari solo se usa cuando en la carta se da una condición concreta, el Dwadashottari solo cuando se da otra, y así sucesivamente. Elegir mal significa aplicar la línea de tiempo equivocada a toda la vida de una persona. Este endpoint aplica esas condiciones por ti. Construye las cartas Rashi, Navamsa y Dwadasamsa a partir de los datos de nacimiento y comprueba seis sistemas condicionales (Ashtottari, Chaturaseeti Sama, Dwadashottari, Dwisaptati, Panchottari y Sataabdika), cada uno con la carta con la que se evalúa tradicionalmente. Envía el momento y el lugar del nacimiento junto con `year_option` (cuántos días tiene el año para el cálculo), `start_option` y `direction_option`, que son los mismos ajustes de periodo que reciben los endpoints de dasha. Con el resultado, decide a qué endpoint de dasha llamar después.

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

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
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. Restricción de FORMATO. DRF DateTimeField: solo ISO-8601 (formatos de entrada por defecto de DRF), p. ej., "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" o "2026-09-01 06:00:00" (sin zona horaria = se toma como UTC).
direction_option	string	obligatorio	`forwardbackward` En minúsculas; distingue mayúsculas y minúsculas. Cualquier otro valor devuelve 400 "Invalid direction: must be 'forward' or 'backward'".
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. `applicability_check` Array de cadenas; solo existe una clave.
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 -90 · max 90
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
start_option	string	obligatorio	`currentnextprevious` En minúsculas; distingue mayúsculas y minúsculas. Cualquier otro valor devuelve 400 "Invalid start value: must be 'current', 'next', or 'previous'". Longitud máxima: 100.
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
year_option	number (double)	obligatorio	`365.256364365.24219365.25365360` min 360 · max 365.256364

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
applicability_check	—	Los sistemas de dasha de nakshatra condicionales cuyas condiciones clásicas cumple esta carta, como lista de nombres para mostrar de entre "Ashtottari Dasha", "Chaturaseeti Sama Dasha", "Dwadashottari Dasha", "Dwisaptati Dasha", "Panchottari Dasha" y "Sataabdika Dasha". Una lista vacía significa que no se aplica ninguno de los seis. El Vimshottari es incondicional y no figura entre ellos.

Ejemplo de solicitud

curl -X POST https://api.occultapi.com/api/astro/dasha_applicability/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["applicability_check"],"date_time":"2025-03-27T09:52:50.441Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year_option":365.256364,"start_option":"current","direction_option":"forward"}'

Respuesta

{
  "data": {
    "applicability_check": []
  },
  "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.