API

API pública de tempo (v1)

Endpoints JSON para o instante actual, conversão de formatos e fusos. CORS *, sem chave API na v1. Limite: 120 requisições a cada 60 segundos por IP; acima disso a resposta é HTTP 429 com o cabeçalho Retry-After. Não usar para temporização crítica de segurança.

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 ou 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 opcionais — devolve desfasamentos e etiquetas ISO em ambos os fusos.

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

Descoberta

GET /api/v1/ devolve um índice JSON. Erros como {"error":"bad_request","message":"..."}.

Parâmetros desconhecidos retornam 400 com a lista dos aceitos (por exemplo, /timezone usa from_tz e to_tz, não tz).

Relacionado: conversor, relógios incorporáveis, sobre o tempo.