Ayudante de Zona Horaria para Horóscopos¶

Utilice este ayudante para obtener los identificadores de zona horaria IANA aceptados antes de llamar a las rutas de informe de días relativos (today, yesterday, tomorrow).

Esto previene errores relacionados con el desplazamiento de fechas entre diferentes regiones y asegura que los usuarios en diferentes ubicaciones resuelvan correctamente el día local.

Endpoint¶

Método	Ruta
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/timezones`

Autenticación¶

Proporcione su encabezado de clave de API:

X-API-Key: YOUR_API_KEY

Parámetros de la Solicitud¶

Este endpoint no requiere parámetros de consulta ni de cuerpo.

Ejemplo de Solicitud¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/timezones" \
  --header "X-API-Key: YOUR_API_KEY"

Ejemplo de Respuesta¶

{
  "count": 596,
  "timezones": [
    "Africa/Abidjan",
    "Africa/Accra",
    "Africa/Addis_Ababa"
  ]
}

Campos de Respuesta¶

Campo	Tipo	Descripción
`count`	entero	Número total de identificadores de zona horaria aceptados devueltos.
`timezones`	array de strings	Nombres de zona horaria IANA soportados.

Flujo de Integración¶

Llama a /api/v1/horoscope/timezones una vez y almacene la lista en su backend/cliente.
Valide la zona horaria seleccionada por el usuario contra esa lista.
Envíe la zona horaria validada en las solicitudes de informe diario.

Ejemplo de solicitud diaria con zona horaria:

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "sign": "TAURUS",
  "timezone": "America/New_York",
  "sections": ["general"]
}'

Notas¶

Utilice el formato IANA válido (por ejemplo: America/New_York, Africa/Douala, Asia/Tokyo).
Evite abreviaturas como EST, PST o GMT+1.
count puede variar ligeramente según el entorno y la versión de tzdata.