Skip to content
Hydrogen

Public

GET /

Section titled “GET /”

Page d’accueil web (Twig). Renvoie du HTML, pas du JSON. Passe par la pile de middleware web (cf. Sessions web (cookie)) — la template a accès aux globals viewer, csrf_token, locale.

  • Auth : aucune
  • Action : HomeAction
  • Réponse : 200 OK (HTML)

GET /api/ping

Section titled “GET /api/ping”

Healthcheck + identité du framework. Retourne un objet JSON simple (pas au format JSON:API — héritage du tout premier endpoint, conservé volontairement pour que les sondes de monitoring (uptime / load balancer) restent indépendantes du format métier).

C’est aussi la seule surface publique qui expose la version d’Hydrogen : aucun header HTTP X-Hydrogen-Version n’est émis sur les autres endpoints (choix sécurité — ne pas divulguer la version au monde sur chaque requête). Les ops qui ont besoin de la corréler avec un incident lisent ici.

  • Auth : aucune
  • Action : PingAction
  • Réponse 200 :
{
  "status":    "ok",
  "timestamp": "2026-06-10T12:34:56+00:00",
  "version":   "0.1.0",
  "codename":  "Protium"
}
  • version : SemVer du framework. Source : fichier VERSION à la racine, miroré dans Hydrogen::VERSION. Tant qu’on est en 0.x, les minor bumps peuvent porter des breaking changes ; la garantie “no breaking without major” s’active à partir de 1.0.0.
  • codename : nom de release. Suit la séquence des isotopes de l’hydrogène (Protium → Deuterium → Tritium → …).