Intégration domotique Biathlon IBU, gratuite et open source

Biathlon IBU : prochaines courses, classements, résultats et statistiques de tir.
Suivez le biathlon dans Gladys avec les données officielles de l'Union internationale de biathlon (datacenter IBU, les données de biathlonresults.com) : dates et heures des prochaines courses, classements de Coupe du monde / IBU Cup, résultats des courses et statistiques de tir de vos athlètes préférés.
C'est une intégration cloud : les données viennent d'Internet, rien ne tourne sur votre réseau local.
1. Obtenir une clé d'API IBU
Le datacenter IBU ne répond qu'aux requêtes portant une clé d'API (en-tête
apikey). Deux façons d'en obtenir une :
-
Une clé personnelle — demandez à l'IBU un accès à l'API de son datacenter (voir biathlonworld.com). C'est la solution la plus propre.
-
La clé du site public — biathlonresults.com envoie une clé avec chaque requête de votre navigateur. Pour la lire :
- ouvrez https://www.biathlonresults.com dans un navigateur d'ordinateur (Chrome, Firefox, Edge) ;
- appuyez sur F12 pour ouvrir les outils de développement, puis l'onglet Réseau ;
- rechargez la page (F5) ;
- tapez
sportapidans le champ de filtre et cliquez sur l'une des requêtes (Events,Competitions…) ; - dans En-têtes → En-têtes de requête, copiez la valeur de
apikey.
Cette clé appartient au site de l'IBU et peut changer à tout moment : si l'intégration indique « L'API IBU a refusé la clé (401) », relisez-la. Utilisez-la raisonnablement, pour un usage personnel.
La clé est stockée par Gladys comme un secret, envoyée uniquement à biathlonresults.com et jamais écrite dans les logs.
2. Configurer l'intégration
- Ouvrez l'onglet Configuration de l'intégration.
- Collez la clé d'API IBU, puis cliquez sur Tester la connexion IBU.
- Athlètes suivis : cliquez sur Trouver un athlète, tapez un nom
(ex.
Jeanmonnot,Perrot,Simon) et copiez l'IBU ID affiché (ex.BTFRA21503199701) dans le champ. Séparez plusieurs ID par des virgules (20 au maximum). - Choisissez le niveau de compétition (Coupe du monde par défaut), la
langue des textes des appareils, votre fuseau horaire
(
Europe/Parispar défaut), l'intervalle de rafraîchissement (15 minutes par défaut, 5 minimum) et le délai de rappel avant course (30 minutes par défaut). - Enregistrez : les appareils apparaissent dans l'onglet Découverte, prêts à être ajoutés.
Appareils
- Calendrier biathlon — prochaine course (nom, lieu, date et heure), minutes avant la prochaine course, dernier vainqueur.
- Classement biathlon — Hommes / Femmes — leader du général et ses points.
- Biathlète nom (un par athlète suivi) — rang et points au général, réussite au tir de la saison (totale, couché, debout, en %), rang et résultat de la dernière course.
La réussite au tir est calculée sur les courses individuelles de la saison en cours (sprint, poursuite, individuel, mass start), 5 cibles par tir. Les relais sont exclus : leurs balles de pioche ne sont pas comparables.
Widgets du tableau de bord
- Prochaines courses de biathlon — les prochaines courses avec date et heure, un badge peu avant le départ et un badge EN DIRECT pendant la course. Réglages : catégorie, nombre de courses.
- Classement biathlon — général, sprint, poursuite, individuel, mass start ou coupe des nations, hommes ou femmes, podium, top 5 ou top 10, athlètes suivis en vert.
- Biathlète — un athlète suivi, choisi en tapant une partie de son nom ou son IBU ID (vide : le premier athlète suivi) : rang, points, jauge de tir, réussite couché et debout, dernière course.
- Derniers résultats de biathlon — podium de la dernière course et places de vos athlètes suivis.
Les widgets suivent la langue de chaque utilisateur de Gladys.
Scènes
Déclencheurs (éditeur de scènes, catégorie Intégrations) :
- Course de biathlon bientôt au départ — une course part dans le délai de
rappel. Filtres : catégorie, discipline. Variables :
{{triggerEvent.data.race}},location,start_time_local,minutes… - Résultats d'une course de biathlon — les résultats d'une course sont
disponibles. Variables :
winner,winner_nation,second,third,race,location… - Résultat d'un athlète suivi — un athlète suivi a terminé une course.
Filtres : athlète, classement (victoire, 2e/3e, top 10, 11e–40e, au-delà).
Variables :
athlete_name,rank,shootings(ex.0+1+0+0),misses,behind,race. - Nouveau leader du général — le dossard jaune a changé d'épaules.
Variables :
leader,leader_nation,points,previous_leader.
Actions :
- Obtenir la prochaine course de biathlon — sorties
found,race,location,start_time_local,minutes_until. - Obtenir les statistiques d'un athlète — sorties
rank,points,shooting_accuracy,prone_accuracy,standing_accuracy,last_rank… - Obtenir le leader d'un classement — sorties
leader,nation,points,second,gap. - Actualiser les données biathlon — lit les données IBU immédiatement.
Exemple : « Course bientôt au départ » → envoyer le message « {{triggerEvent.data.race}} à {{triggerEvent.data.location}} part à {{triggerEvent.data.start_time_local}} » et allumer la télé.
Les textes des variables de scène utilisent la langue choisie dans la configuration. Une détection ne se déclenche qu'une fois : l'intégration se souvient de ce qu'elle a déjà annoncé, même après un redémarrage. Juste après l'installation, le premier rafraîchissement apprend le passé sans rien déclencher.
Dépannage
- « Saisissez votre clé d'API IBU » — le champ de la clé est vide.
- « L'API IBU a refusé la clé (401) » — la clé est fausse ou a expiré : récupérez-en une nouvelle (voir l'étape 1).
- Aucune course — entre deux saisons, le calendrier peut être vide ; vérifiez le niveau de compétition.
- Consultez les logs de l'intégration depuis l'interface de Gladys
(
LOG_LEVEL=debugpour le détail complet).
Les données appartiennent à l'IBU. Cette intégration n'est pas affiliée à l'IBU.
Paramètres de configuration
Voici les paramètres demandés par Biathlon IBU dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Obtenir une clé d'API IBU | section | Non | Le datacenter IBU (biathlonresults.com) exige une clé d'API. Demandez une clé personnelle à l'IBU, ou réutilisez la clé du site public : ouvrez biathlonresults.com dans un navigateur d'ordinateur, appuyez sur F12, ouvrez l'onglet Réseau, rechargez la page, cliquez sur une requête vers « sportapi » et copiez la valeur de son en-tête « apikey ». Détails dans la documentation. |
| Clé d'API IBU | secret | Oui | Envoyée uniquement à biathlonresults.com, dans l'en-tête « apikey ». |
| Athlètes suivis | string | Non | IBU ID séparés par des virgules (20 au maximum). Utilisez le bouton « Trouver un athlète » ci-dessous pour les obtenir. |
| Niveau de compétition | select | Non | |
| Langue des textes des appareils | select | Non | Les widgets suivent la langue de chaque utilisateur ; les états des appareils et les variables de scène utilisent celle-ci. |
| Fuseau horaire | string | Non | Fuseau horaire IANA des heures de départ affichées. |
| Intervalle de rafraîchissement (min) | number | Non | Fréquence de lecture des données IBU, en minutes (5 minimum). |
| Rappel avant course (min) | number | Non | Minutes avant le départ auxquelles le déclencheur « Course bientôt au départ » se déclenche. |
Comment installer Biathlon IBU dans Gladys
- Dans Gladys, ouvrez Intégrations : Biathlon IBU 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/gboulvin/gladys-ibu:1.1.0), 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/gboulvin/Gladys-IBU.
Biathlon IBU nécessite Gladys >=5.1.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
Biathlon IBU 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 gboulvin, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation