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

Escaneo de mes lunar

Encuentra los instantes exactos de inicio y fin de un mes lunar hindú concreto (Chaitra, Vaisakha, Jyeshtha, etc.) dentro de un año del calendario. Sirve para programar cualquier cosa ligada a un mes lunar y no a uno gregoriano. reckoning decide dónde caen los límites. Con 'amanta' (valor por defecto, usado en el sur y el oeste), el mes va de una luna nueva a la siguiente y toma su nombre del signo de la Luna en la luna nueva con que empieza. Con 'poornima' va de una luna llena a la siguiente y toma su nombre del signo del Sol en la luna llena con que empieza; es el cómputo de los calendarios del norte, y en la quincena oscura los dos sitúan el mismo día en meses con nombres distintos. Pasa month_name, year y timezone_as_float; no hace falta ningún lugar. La respuesta es {year, month_name, reckoning, rows}, donde rows es una lista de marcas de tiempo UTC {start, end}: normalmente una sola entrada, o dos cuando ese año también cae un mes adhika (intercalar) con el mismo nombre. El escaneo no indica cuál de los dos es el intercalar.

https://api.occultapi.com/api/astro/lunar_month_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
month_name	string	obligatorio	`VaisakhaJyeshthaAshadhaShravanaBhadrapadaAshwinKartikaMargashirshaPaushaMaghaPhalgunaChaitra`
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
reckoning	string	opcional	`amantapoornima`

Ejemplo de solicitud

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

Respuesta

{
  "data": {
    "year": 2026,
    "month_name": "Vaisakha",
    "reckoning": "amanta",
    "rows": [
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-05-16T20:01:32+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.