API & badge

L'heure du goûter, partout où tu en as besoin. Gratuit, sans clé, CORS ouvert.

Badge

Un badge qui se met à jour tout seul, pour un README ou un tableau de bord :

![Heure du goûter](https://estcequecestbientotlheuredugouter.fr/api/badge)

<img src="https://estcequecestbientotlheuredugouter.fr/api/badge?tz=Europe/Paris" alt="Heure du goûter">

Paramètres : tz (fuseau IANA, défaut Europe/Paris), hour (0-23, défaut 16), label (texte de gauche).

API JSON

GET https://estcequecestbientotlheuredugouter.fr/api/status?tz=Europe/Paris&hour=16

{
  "state": "bientot",            // "non" | "bientot" | "cest-lheure"
  "answer": "Bientôt",
  "face": "ಠ‿ಠ",
  "isGouterTime": false,
  "msUntilStart": 1834000,
  "msUntilEnd": 0,
  "nextGouterAt": "2026-11-07T15:00:00.000Z",
  "gouterHour": 16,
  "timezone": "Europe/Paris",
  "special": null,
  "generatedAt": "2026-11-07T14:29:26.000Z"
}

Exemple en une ligne :

curl -s https://estcequecestbientotlheuredugouter.fr/api/status | jq -r '.answer + " " + .face'