El lento recorrido de Saturno por el zodíaco da lugar a cuatro fases con nombre propio que la astrología india sigue muy de cerca, todas medidas desde la Luna natal o el ascendente natal: Sade Sati, los siete años y medio en torno al paso de Saturno sobre ese punto; Ashtama Shani, Saturno en la octava casa desde él; Kantaka Shani, Saturno en la cuarta, la séptima o la décima; y Dhaiya, también llamado Ardhashtama, Saturno en la cuarta o la octava. Este endpoint indica si cada una está en curso en un momento dado, cuándo termina y cuándo empieza la siguiente.
Envía dos cartas: los datos de nacimiento en `date_time_natal`, `latitude_natal`, `longitude_natal` y `chart_name_natal`, y el momento que te interesa en los campos `_transit` equivalentes. `ref_celestial` elige si las fases se miden desde la Luna natal o desde el ascendente natal. `mode` fija lo estricta que es la comprobación: 0 mira la posición por casas de signo entero, y los valores más altos comprueban en cambio una franja de grados en torno al punto de referencia, lo que da fechas de inicio y fin bastante más ajustadas.
La respuesta contiene ocho objetos. `ashtama_shani`, `kantaka_shani`, `dhaiya_shani` y `sade_sati_shani` tienen la forma `{status, end_date}`: un booleano que indica si la fase está en curso en el momento del tránsito y, si lo está, una fecha de fin en ISO 8601 y UTC, o null si no lo está. `next_ashtama_shani`, `next_kantaka_shani` y `next_dhaiya_shani` tienen la forma `{date, ref_house_from_natal}`: cuándo empieza la siguiente vez y qué casa desde el punto de referencia la activa; `next_sade_sati_shani` da solo `{date}`. La búsqueda hacia delante abarca cien años desde el momento del tránsito.
Como Kantaka y Dhaiya incluyen ambas la cuarta casa, a menudo devuelven las mismas fechas. Es lo esperado, no un duplicado.
Campos de la solicitud
| Campo | Tipo | Obligatorio | Notas |
|---|
| chart_name_natal | string | obligatorio | |
| chart_name_transit | string | obligatorio | |
| date_time_natal | string (date-time) | obligatorio | |
| date_time_transit | string (date-time) | obligatorio | |
| latitude_natal | number (double) | obligatorio | min -180 · max 180 |
| latitude_transit | number (double) | obligatorio | min -180 · max 180 |
| longitude_natal | number (double) | obligatorio | min -180 · max 180 |
| longitude_transit | number (double) | obligatorio | min -180 · max 180 |
| mode | integer | obligatorio | |
| ref_celestial | string | obligatorio | |
Referencia completa de este endpoint