Cargando el Playground
curl -X POST https://api.occultapi.com/api/astro/telugu_calendar/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'El calendario telugu es lunisolar Amanta: los meses van de una luna nueva a la siguiente, llevan nombres telugu (Chaithramu, Vaisakhamu, Jyesthamu, Ashadhamu, Sravanamu, Bhadhrapadamu, Asvayujamu, Karthikamu, Margasiramu, Pushyamu, Maghamu y Phalgunamu), y el año se computa en Shaka Samvat y empieza en Ugadi, en Chaithramu Shukla Padyami. La aritmética subyacente de los meses, incluida la detección del mes adhika, es la misma que usan los calendarios maratí y kannada: lo que diferencia a los tres es la denominación de los meses y la lista de festivales, no la astronomía. No es el esquema solar de signo a signo de los calendarios tamil y malayalam. Envía un `year` por POST con `latitude`, `longitude` y `timezone_as_float`. La respuesta es `{year, events}` y cada evento es simplemente `{name, date}`; a diferencia del calendario tamil, no hay campos de mes ni de día del mes. Cabe esperar unas noventa entradas al año: los veinticuatro Ekadashis (veintiséis en un año adhika) con sus nombres telugu, junto con las alternativas Gauna y Vaishnava del día siguiente que la mayoría de los demás calendarios regionales omiten, unos veinticinco Pradosh Vrats con nombre de día de la semana (Ravi, Soma, Bhauma, Budha, Guru, Shukra, Shani), los doce Sankashtahara Chaturthis, los doce vratas de Shukla Dwadashi y los festivales principales. La salida del sol, la puesta del sol y la franja de Pradosha se calculan para las coordenadas que envíes, así que en otra ciudad una fecha puede cambiar un día; en particular, la regla del Pradosh Vrat asigna cada Trayodashi al día civil con cuya franja de Pradosha posterior a la puesta del sol más se solapa. Los festivales compartidos con el calendario hindú principal se leen de la tabla precalculada, que solo abarca 2006-2046.
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| 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. |
| 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. |
| 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 2006 · max 2046 |