API

API temps publique (v1)

Points de terminaison JSON pour l’instant courant, la conversion de formats et de fuseaux. CORS *, pas de clé API en v1. Limite : 120 requêtes par 60 secondes et par IP ; au-delà, réponse HTTP 429 avec un en-tête Retry-After. Pas pour le timing critique.

GET /api/v1/now

Query : format (iso | unix | unix_ms | rfc2822 | http | custom), tz (IANA), pattern optionnel pour 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 optionnel.

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 optionnels — renvoie décalages et libellés ISO dans les deux fuseaux.

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

Découverte

GET /api/v1/ renvoie un index JSON. Erreurs du type {"error":"bad_request","message":"..."}.

Un paramètre inconnu renvoie 400 avec la liste des paramètres acceptés (par exemple, /timezone attend from_tz et to_tz, pas tz).

Voir aussi : convertisseur, horloges intégrables, à propos du temps.