Cargando el Playground
curl -X POST https://api.occultapi.com/api/astro/patyayini_dasha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dasha_periods"],"date_time":"2025-02-13T05:07:54.585Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'El Patyayini es uno de los sistemas de periodos que se usan con la carta anual Tajaka, la carta levantada para el momento en que el Sol vuelve cada año a su longitud natal. El Vimshottari divide el tiempo por nakshatras; el Patyayini, en cambio, divide el año según las distancias entre los planetas: los siete planetas clásicos se ordenan por longitud, el arco de cada uno al siguiente fija la parte de ese planeta y las partes se escalan para sumar exactamente un año. El resultado indica qué planeta rige cada tramo de los próximos doce meses y qué planeta rige cada subperiodo dentro de ese tramo. Tiene una sola clave: `get_dasha_periods`. Envía en `date_time` el momento desde el que quieres medir el año, además de `latitude`, `longitude` y `timezone_as_float`. Rahu y Ketu no intervienen. Dos detalles sobre la estructura. Los planetas se devuelven como índices enteros en el orden Sol, Luna, Marte, Mercurio, Júpiter, Venus, Saturno, así que 0 es el Sol y 6 es Saturno. Y las horas de inicio de los subperiodos son cadenas con una fecha seguida de un diccionario convertido en texto, por ejemplo `"2025-02-13 {'degrees': 5, 'minutes': 7, 'seconds': 54.0}"`, donde degrees, minutes y seconds son las horas, minutos y segundos del día, no un ángulo. Tenlo en cuenta al analizarlas.
| 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. |
| 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. |
| 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 |
| 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 |
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_dasha_periods | — | La secuencia completa del Patyayini para un año: una lista de `[planet, sub_periods, duration]`, una entrada por periodo mayor. `planet` es un índice entero en Sol, Luna, Marte, Mercurio, Júpiter, Venus, Saturno; `duration` es la duración de ese periodo en días, y las duraciones de toda la lista suman aproximadamente 365.24. `sub_periods` es una lista de siete pares `[lord, start]`, donde `lord` es el mismo índice entero y `start` una cadena de la forma `"YYYY-MM-DD {'degrees': H, 'minutes': M, 'seconds': S}"`, en la que los tres números son las horas, minutos y segundos de ese día. |