API

API pública de tiempo (v1)

Endpoints JSON para el instante actual, conversión de formatos y zonas. CORS *, sin clave API en v1. Límite: 120 solicitudes cada 60 segundos por IP; si lo superas, recibes HTTP 429 con la cabecera Retry-After. No usar para temporización crítica de seguridad.

GET /api/v1/now

Query: format (iso | unix | unix_ms | rfc2822 | http | custom), tz (IANA), pattern opcional para custom (YYYY MM DD HH mm ss Z X x).

curl "https://time.foo/api/v1/now?format=iso&tz=Asia/Singapore"

GET /api/v1/convert

Query: from (ISO o unix s/ms), from_tz, to_tz, format, pattern opcional.

curl "https://time.foo/api/v1/convert?from=1700000000&to_tz=America/New_York&format=iso"

GET /api/v1/timezone

Query: time, from_tz, to_tz opcionales — devuelve desfases y etiquetas ISO en ambas zonas.

curl "https://time.foo/api/v1/timezone?from_tz=UTC&to_tz=Asia/Tokyo"

Descubrimiento

GET /api/v1/ devuelve un índice JSON. Errores como {"error":"bad_request","message":"..."}.

Los parámetros desconocidos devuelven 400 con la lista de los permitidos (por ejemplo, /timezone usa from_tz y to_tz, no tz).

Relacionado: convertidor, relojes insertables, acerca del tiempo.