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

Resolución de zona horaria

Convierte una hora de nacimiento, tal como la marca el reloj, y unas coordenadas en un instante inequívoco. Todos los demás endpoints piden una marca de tiempo con zona horaria o una diferencia con UTC numérica, y equivocarse en eso es la causa más frecuente de que una carta salga, sin ningún aviso, con una hora o un día de error; por eso suele ser la primera llamada que haces. Envía `date`, `time`, `latitude` y `longitude`. Se obtiene la zona horaria IANA de las coordenadas, la fecha y la hora sin zona se interpretan en esa zona, y recibes `input_datetime`, el nombre de la zona en `timezone`, `localized_datetime` con su diferencia con UTC incluida y `utc_datetime`. Pasa el valor localizado tal cual a `date_time` en los demás endpoints. Una salvedad: el campo de la solicitud se escribe `use_LMT`, pero la vista lee un nombre escrito de otra forma, así que la hora media local nunca se llega a aplicar y siempre se usa la zona IANA; `use_lmt` en la respuesta es siempre false. Para nacimientos anteriores a la adopción local de la hora estándar, calcula por tu cuenta la diferencia de la hora media local (cuatro minutos por grado de longitud) en lugar de confiar en este indicador.

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

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
date	string (date)	obligatorio	Restricción de FORMATO, no un enum. DRF DateField con los formatos de entrada por defecto = solo ISO-8601: 'YYYY-MM-DD'.
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. min -180 · max 180
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. min -180 · max 180
time	string (time)	obligatorio	Restricción de FORMATO, no un enum. DRF TimeField con los formatos de entrada por defecto = solo ISO-8601: 'HH:MM', 'HH:MM:SS' o 'HH:MM:SS.ffffff'. El valor de ejemplo del catálogo, "string", es engañoso.
use_LMT	boolean	opcional

Ejemplo de solicitud

curl -X POST https://api.occultapi.com/api/astro/date_time/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1980-09-05","time":"04:42:05.037Z","longitude":80,"latitude":23,"use_LMT":true}'

Respuesta

{
  "input_datetime": "1980-09-05 04:42:05",
  "latitude": 23,
  "longitude": 80,
  "timezone": "Asia/Kolkata",
  "use_lmt": false,
  "localized_datetime": "1980-09-05T04:42:05.037000+05:30",
  "utc_datetime": "1980-09-04T23:12:05.037000+00:00"
}

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.