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

Escaneo anual de Nitya Yoga

El Nitya Yoga es la vigésima séptima parte del círculo que se obtiene al sumar las longitudes siderales del Sol y de la Luna. Cada uno de los veintisiete (de Vishkambha a Vaidhriti) dura algo menos de un día, y son importantes en la astrología electiva: tradicionalmente se evitan Vyatipata, Vaidhriti, Parigha, Vyaghata, Shoola, Ganda y Atiganda, mientras que se buscan los yogas Siddhi, Siddha, Shubha, los de clase Amrita y Sukarma. Este endpoint recibe un yoga por su nombre y devuelve todas sus ocurrencias en un año del calendario. `yoga_name` distingue mayúsculas y minúsculas y debe coincidir exactamente con el enum. `year` y `timezone_as_float` definen el año local que se cubre, y no se necesitan coordenadas porque el yoga cambia en el mismo instante en todas partes. Como la suma de las dos longitudes avanza unos 13 grados y 20 minutos cada 22.6 horas, cada yoga vuelve unas catorce o quince veces al año. La respuesta es `{year, yoga_name, rows}`, donde `rows` es una lista cronológica de marcas de tiempo ISO en UTC `{start, end}`. Cada par es el instante real de inicio y fin de ese yoga, hallado por bisección de la suma de longitudes del Sol y la Luna y no por muestreo a la salida del sol, así que los límites tienen una precisión de una fracción de segundo.

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

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

timezone_as_float

number (double)

Campo	Tipo	Obligatorio	Notas
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.
year	integer	obligatorio	Año de nacimiento como número, p. ej., 1990. Cuatro dígitos. min 1800 · max 2400
yoga_name	string	obligatorio	`VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva`

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.

year

integer

obligatorio

Año de nacimiento como número, p. ej., 1990. Cuatro dígitos.

min 1800 · max 2400

yoga_name

string

obligatorio

VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva

Ejemplo de solicitud

curl -X POST https://api.occultapi.com/api/astro/yoga_scan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timezone_as_float":5.5,"year":2026,"yoga_name":"Vishkambha"}'

Respuesta

{
  "data": {
    "year": 2026,
    "yoga_name": "Vishkambha",
    "rows": [
      {
        "start": "2026-01-04T20:17:27.999999+00:00",
        "end": "2026-01-05T17:17:16.999999+00:00"
      },
      {
        "start": "2026-01-30T11:28:35.999999+00:00",
        "end": "2026-01-31T08:03:35.999999+00:00"
      },
      {
        "start": "2026-02-24T22:56:20.999999+00:00",
        "end": "2026-02-25T19:58:43.999999+00:00"
      },
      {
        "start": "2026-03-22T10:11:35.999999+00:00",
        "end": "2026-03-23T06:52:06.999999+00:00"
      },
      {
        "start": "2026-04-17T01:51:55.999999+00:00",
        "end": "2026-04-17T22:15:28.999999+00:00"
      },
      {
        "start": "2026-05-12T17:49:31.999999+00:00",
        "end": "2026-05-13T15:24:49.999999+00:00"
      },
      {
        "start": "2026-06-07T04:31:57.999999+00:00",
        "end": "2026-06-08T03:58:13.999999+00:00"
      },
      {
        "start": "2026-07-02T11:09:21.999999+00:00",
        "end": "2026-07-03T11:30:01.999999+00:00"
      },
      {
        "start": "2026-07-27T17:24:55.999999+00:00",
        "end": "2026-07-28T18:03:37.999999+00:00"
      },
      {
        "start": "2026-08-21T23:48:40.999999+00:00",
        "end": "2026-08-23T00:44:33.999999+00:00"
      },
      {
        "start": "2026-09-16T06:52:40.999999+00:00",
        "end": "2026-09-17T07:19:46.999999+00:00"
      },
      {
        "start": "2026-10-11T15:35:35.999999+00:00",
        "end": "2026-10-12T15:02:25.999999+00:00"
      },
      {
        "start": "2026-11-05T23:39:40.999999+00:00",
        "end": "2026-11-06T22:40:11.999999+00:00"
      },
      {
        "start": "2026-12-01T06:45:12.999999+00:00",
        "end": "2026-12-02T05:01:50.999999+00:00"
      },
      {
        "start": "2026-12-26T18:52:33.999999+00:00",
        "end": "2026-12-27T15:23:47.999999+00:00"
      }
    ]
  },
  "message": "successful",
  "is_error": false
}

Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.

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.