Intégration GRDF Gazpar pour Gladys Assistant
Lit la consommation de gaz quotidienne de votre compteur Gazpar depuis votre compte GRDF.
Publiée par PhilippeMA
- Appareils
- Version 1.1.4
- Nécessite Gladys >=4.62.0
- ★ 1
Cette intégration lit la consommation de gaz mesurée par votre compteur Gazpar et la transforme en appareils Gladys : votre gaz apparaît alors à côté du reste des données de votre maison — courbes quotidiennes, scènes et écran énergie.
GRDF ne propose pas d'API publique pour les particuliers. L'intégration se connecte donc à votre compte client comme le ferait un navigateur, sur monespace.grdf.fr, et lit exactement les relevés quotidiens que le site vous affiche.
Ce qu'il vous faut
- un compte client GRDF (celui de monespace.grdf.fr), avec votre compteur déjà rattaché ;
- un compteur communicant Gazpar : les relevés quotidiens n'existent que pour ceux-là. Avec un ancien compteur relevé deux fois par an par un technicien, GRDF ne publie qu'un relevé global par période, et c'est tout ce que l'intégration pourra afficher ;
- un compte qui ne demande pas d'étape de vérification supplémentaire à la connexion (code à usage unique par SMS ou e-mail, captcha) : l'intégration ne sait répondre qu'à l'étape du mot de passe.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Saisissez l'e-mail et le mot de passe de votre compte GRDF. Le mot de passe est stocké chiffré par Gladys et n'est transmis qu'à GRDF.
- Laissez PCE à suivre vide pour suivre tous les compteurs du compte. Si votre compte comporte plusieurs points de comptage et que vous n'en voulez qu'une partie, listez leurs numéros de PCE à 14 chiffres, séparés par des virgules. Un PCE figure sur votre facture de gaz et dans Mon Espace GRDF.
- Choisissez l'historique à importer : le nombre de jours passés récupérés lors de la première synchronisation. GRDF conserve environ trois ans, vous pouvez donc importer plusieurs mois d'un coup pour obtenir des courbes qui ont déjà un passé. Cela ne concerne que la première synchronisation ; ensuite, l'intégration ne récupère que les nouveautés. Importer un long historique prend quelques minutes : Gladys n'accepte qu'un nombre limité de mesures par minute, l'intégration les injecte donc en douceur — comptez environ une minute par deux mois importés.
- Cliquez sur Tester la connexion GRDF : elle se connecte et liste les points de comptage trouvés. C'est le moyen le plus rapide de vérifier vos identifiants.
- Enregistrez, puis ouvrez l'onglet Découverte et ajoutez votre compteur à votre maison. C'est cette étape qui déclenche la collecte : tant qu'un compteur n'est pas ajouté, ce n'est qu'une proposition, et Gladys n'a nulle part où ranger ses mesures. L'historique est importé dès que vous l'ajoutez.
Les appareils obtenus
Un appareil par point de comptage, nommé d'après l'alias que vous lui avez donné dans Mon Espace, portant quatre capteurs en lecture seule :
| Capteur | Unité | Ce que c'est |
|---|---|---|
| Consommation quotidienne | kWh | Énergie consommée pendant la journée gazière (facturée) |
| Volume quotidien | m³ | Volume brut de gaz consommé pendant la journée gazière |
| Index compteur | m³ | Index du compteur à la fin de la journée gazière |
| Température extérieure moyenne | °C | Température extérieure moyenne associée au jour par GRDF |
Chaque valeur est enregistrée à la date du jour qu'elle concerne, et non à la date de son téléchargement : vos courbes restent justes malgré le retard de publication.
Quand arrivent les données
GRDF publie un relevé avec un à deux jours de retard, généralement dans la journée qui suit la mesure. Rien n'est temps réel ici : la consommation du lundi arrive typiquement le mardi ou le mercredi. C'est une limite du réseau Gazpar lui-même (le compteur n'émet qu'une fois par jour), pas de l'intégration.
L'intégration interroge GRDF selon son propre calendrier — toutes les six heures par défaut, ce qui est largement suffisant pour une valeur quotidienne. L'action Rafraîchir les données maintenant force une récupération immédiate si vous ne voulez pas attendre.
En cas de problème
« Tester la connexion GRDF » échoue. Essayez de vous connecter sur monespace.grdf.fr avec les mêmes identifiants dans une fenêtre de navigation privée. Si GRDF vous y demande un code ou un captcha, l'intégration ne passera pas non plus.
Les capteurs existent mais restent vides. Vérifiez que le compteur est bien ajouté à votre maison, et pas seulement listé dans l'onglet Découverte : Gladys ne conserve les mesures que des appareils que vous avez ajoutés. Une fois ajouté, l'historique est importé en quelques secondes, et au pire dans la minute — ou utilisez Rafraîchir les données maintenant. Un long historique met quelques minutes à s'afficher entièrement : il est injecté en douceur (voir ci-dessus), du jour le plus ancien au plus récent.
« GRDF served its HTML app shell » ou « the session was not accepted ». GRDF a répondu par une page web au lieu de données. Son site fait cela quand il n'accepte pas la session, mais aussi quand il traverse simplement un mauvais moment — il ne dit jamais lequel des deux. L'intégration se reconnecte et réessaie seule plusieurs fois ; si cela échoue encore, patientez quelques minutes puis utilisez Rafraîchir les données maintenant. Si cela persiste, vérifiez que monespace.grdf.fr fonctionne dans votre navigateur : GRDF freine parfois un compte qui s'est connecté de nombreuses fois d'affilée.
Aucune donnée nouvelle depuis plusieurs jours. Vérifiez sur le site GRDF que les relevés sont bien publiés pour votre compteur : un Gazpar qui a perdu sa liaison radio n'alimente plus GRDF, et l'intégration ne peut montrer que ce que GRDF possède.
Les valeurs semblent fausses ou dupliquées. L'intégration mémorise le dernier jour publié pour chaque compteur : elle ne réimporte jamais deux fois le même jour. Si vous supprimez un appareil puis le recréez, son historique repart de la fenêtre d'import configurée.
Pour le détail de ce qui se passe, consultez les logs de l'intégration depuis
l'interface Gladys (ou docker logs sur l'hôte) ; passez LOG_LEVEL=debug pour
la version bavarde.
Vie privée
Vos identifiants GRDF et vos données de consommation restent entre votre serveur Gladys et GRDF. Rien n'est envoyé ailleurs, aucun service tiers n'intervient.
Paramètres de configuration
Voici les paramètres demandés par GRDF Gazpar dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Avant de commencer | section | Non | Cette intégration se connecte à votre compte client GRDF, celui de monespace.grdf.fr, et lit les relevés quotidiens de votre compteur Gazpar. GRDF les publie avec un à deux jours de retard : rien n'arrive en temps réel. Votre compte ne doit pas demander d'étape de vérification supplémentaire à la connexion. |
| E-mail du compte GRDF | string | Oui | L'adresse e-mail utilisée pour vous connecter sur monespace.grdf.fr. |
| Mot de passe du compte GRDF | secret | Oui | Stocké chiffré par Gladys et transmis uniquement à GRDF. |
| PCE à suivre | string | Non | Facultatif. Identifiants de point de comptage à 14 chiffres, séparés par des virgules. Laissez vide pour suivre tous les compteurs du compte. |
| Historique à importer (jours) | number | Non | Nombre de jours de consommation passée importés à la première synchronisation. GRDF conserve environ trois ans. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence d'interrogation de GRDF, en secondes. Un nouveau relevé n'arrive qu'une fois par jour : inutile de descendre en dessous de quelques heures. |
Comment installer GRDF Gazpar dans Gladys
- Dans Gladys, ouvrez Intégrations : GRDF Gazpar apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/philippema/gladys-grdf:1.1.4), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/PhilippeMA/gladys-grdf.
GRDF Gazpar nécessite Gladys >=4.62.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
GRDF Gazpar est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par PhilippeMA, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation