API

Öffentliche Zeit-API (v1)

JSON-Endpunkte für den aktuellen Moment, Format- und Zeitzonenumwandlung. CORS *, kein API-Schlüssel in v1. Limit: 120 Anfragen pro 60 Sekunden je IP; darüber antwortet die API mit HTTP 429 und einem Retry-After-Header. Nicht für sicherheitskritische Zeitmessung.

GET /api/v1/now

Query: format (iso | unix | unix_ms | rfc2822 | http | custom), tz (IANA), optional pattern für 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 oder Unix s/ms), from_tz, to_tz, format, optional pattern.

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

GET /api/v1/timezone

Query: optional time, from_tz, to_tz — liefert Offsets und ISO-Labels in beiden Zonen.

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

Entdeckung

GET /api/v1/ liefert einen JSON-Index. Fehler z. B. {"error":"bad_request","message":"..."}.

Unbekannte Parameter ergeben 400 mit der Liste der erlaubten Parameter (z. B. erwartet /timezone from_tz und to_tz, nicht tz).

Verwandt: Konverter, einbettbare Uhren, über Zeit.