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

Escaneo anual de un tithi

Un tithi es la trigésima parte del mes lunar: el tiempo que tarda la Luna en ganar otros 12 grados de elongación respecto al Sol. Los tithis son la unidad sobre la que se define casi toda observancia hindú, y no coinciden con los días civiles: uno puede durar apenas unas diecinueve horas o hasta unas veintiséis, así que una sola ocurrencia suele abarcar dos fechas. Este endpoint recibe un tithi concreto y devuelve todas sus ocurrencias en un año del calendario, con el instante real en que empieza y termina. `tithi_number` va de 1 a 30: del 1 al 15 son de Shukla Pratipada a Purnima, del 16 al 29 de Krishna Pratipada a Chaturdashi, y el 30 es Amavasya. `year` es el año del calendario local y `timezone_as_float` decide de qué año local se trata (5.5 para IST). No se necesitan coordenadas, porque un tithi empieza y termina en el mismo instante en toda la Tierra. La respuesta es `{year, tithi_number, rows}`, donde `rows` es una lista cronológica de marcas de tiempo ISO en UTC `{start, end}`; suele tener doce o trece entradas, ya que cada tithi se repite una vez por mes lunar. Las franjas no se cortan en las salidas del sol intermedias, así que una ocurrencia que abarca dos días civiles se devuelve como una sola fila.

https://api.occultapi.com/api/astro/tithi_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)	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.
tithi_number	integer	obligatorio	min 1 · max 30
year	integer	obligatorio	Año de nacimiento como número, p. ej., 1990. Cuatro dígitos. min 1800 · max 2400

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.

tithi_number

integer

obligatorio

min 1 · max 30

year

integer

obligatorio

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

min 1800 · max 2400

Ejemplo de solicitud

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

Respuesta

{
  "data": {
    "year": 2026,
    "tithi_number": 1,
    "rows": [
      {
        "start": "2026-01-18T19:52:39+00:00",
        "end": "2026-01-19T20:45:19+00:00"
      },
      {
        "start": "2026-02-17T12:01:47+00:00",
        "end": "2026-02-18T11:28:41+00:00"
      },
      {
        "start": "2026-03-19T01:24:05+00:00",
        "end": "2026-03-19T23:23:24+00:00"
      },
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-04-18T08:41:36+00:00"
      },
      {
        "start": "2026-05-16T20:01:32+00:00",
        "end": "2026-05-17T16:11:46+00:00"
      },
      {
        "start": "2026-06-15T02:54:39+00:00",
        "end": "2026-06-15T23:01:51+00:00"
      },
      {
        "start": "2026-07-14T09:44:04+00:00",
        "end": "2026-07-15T06:21:58+00:00"
      },
      {
        "start": "2026-08-12T17:37:11+00:00",
        "end": "2026-08-13T15:12:30+00:00"
      },
      {
        "start": "2026-09-11T03:27:28+00:00",
        "end": "2026-09-12T02:17:22+00:00"
      },
      {
        "start": "2026-10-10T15:50:36+00:00",
        "end": "2026-10-11T16:02:05+00:00"
      },
      {
        "start": "2026-11-09T07:02:42+00:00",
        "end": "2026-11-10T08:31:14+00:00"
      },
      {
        "start": "2026-12-09T00:52:31+00:00",
        "end": "2026-12-10T03:17:14+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.