Biathlon IBU Smart-Home-Integration, kostenlos und Open Source

IBU-Biathlon: nächste Rennen, Weltcup-Wertungen, Ergebnisse und Schießstatistik.
Verfolgen Sie Biathlon in Gladys mit den offiziellen Daten der Internationalen Biathlon-Union (IBU-Datacenter, die Daten von biathlonresults.com): Datum und Uhrzeit der nächsten Rennen, Weltcup- / IBU-Cup-Wertungen, Rennergebnisse und Schießstatistiken Ihrer Lieblingsathleten.
Dies ist eine Cloud-Integration: Die Daten kommen aus dem Internet, nichts läuft in Ihrem lokalen Netzwerk.
1. Einen IBU-API-Schlüssel erhalten
Das IBU-Datacenter beantwortet nur Anfragen mit einem API-Schlüssel (Header
apikey). Zwei Möglichkeiten:
-
Ein persönlicher Schlüssel — fragen Sie bei der IBU nach einem Zugang zur Datacenter-API (siehe biathlonworld.com). Das ist die sauberste Lösung.
-
Der Schlüssel der öffentlichen Website — biathlonresults.com sendet bei jeder Anfrage Ihres Browsers einen Schlüssel mit. So lesen Sie ihn:
- öffnen Sie https://www.biathlonresults.com in einem Desktop-Browser;
- drücken Sie F12 und öffnen Sie den Tab Netzwerk;
- laden Sie die Seite neu (F5);
- geben Sie
sportapiin das Filterfeld ein und klicken Sie auf eine Anfrage (Events,Competitions…); - kopieren Sie unter Header → Anfrage-Header den Wert von
apikey.
Dieser Schlüssel gehört zur IBU-Website und kann sich jederzeit ändern: Meldet die Integration „Die IBU-API hat den Schlüssel abgelehnt (401)“, lesen Sie ihn erneut aus. Nutzen Sie ihn maßvoll und nur privat.
Der Schlüssel wird von Gladys als Geheimnis gespeichert, nur an biathlonresults.com gesendet und nie protokolliert.
2. Die Integration konfigurieren
- Öffnen Sie den Tab Konfiguration der Integration.
- Fügen Sie den IBU-API-Schlüssel ein und klicken Sie auf IBU-Verbindung testen.
- Verfolgte Athleten: Klicken Sie auf Athlet suchen, geben Sie einen
Nachnamen ein (z. B.
Preuss,Voigt) und kopieren Sie die angezeigte IBU-ID in das Feld. Mehrere IDs durch Kommas trennen (höchstens 20). - Wählen Sie die Wettkampfebene (standardmäßig Weltcup), die Sprache der Gerätetexte, Ihre Zeitzone, das Aktualisierungsintervall (standardmäßig 15 Minuten, mindestens 5) und die Rennerinnerung (standardmäßig 30 Minuten).
- Speichern: Die Geräte erscheinen im Tab Erkennung.
Geräte
- Biathlon-Kalender — nächstes Rennen (Name, Ort, Datum und Uhrzeit), Minuten bis zum nächsten Rennen, letzter Sieger.
- Biathlon-Wertung — Herren / Damen — Gesamtführender und Punkte.
- Biathlet Name (einer pro verfolgtem Athleten) — Gesamtplatz und Punkte, Trefferquote der Saison (gesamt, liegend, stehend, in %), Platz und Ergebnis des letzten Rennens.
Die Trefferquote wird über die Einzelrennen der laufenden Saison berechnet (Sprint, Verfolgung, Einzel, Massenstart), 5 Scheiben pro Schießeinlage. Staffeln sind ausgenommen (Nachladepatronen).
Dashboard-Widgets
- Nächste Biathlonrennen — Datum und Uhrzeit, ein Hinweis kurz vor dem Start und LIVE während des Rennens.
- Biathlon-Wertung — Gesamt, Sprint, Verfolgung, Einzel, Massenstart oder Nationencup, Podium, Top 5 oder Top 10, verfolgte Athleten in Grün.
- Biathlet — ein verfolgter Athlet, gewählt über einen Teil seines Namens oder seine IBU-ID (leer: der erste verfolgte Athlet): Platz, Punkte, Trefferquote, liegend und stehend, letztes Rennen.
- Letzte Biathlon-Ergebnisse — Podium des letzten Rennens und Plätze der verfolgten Athleten.
Szenen
Auslöser: Biathlonrennen startet bald, Ergebnisse eines Biathlonrennens, Ergebnis eines verfolgten Athleten, Neuer Gesamtführender. Aktionen: Nächstes Biathlonrennen abrufen, Statistik eines Athleten abrufen, Führenden einer Wertung abrufen, Biathlon-Daten aktualisieren. Die Variablen sind in der englischen Dokumentation beschrieben.
Fehlerbehebung
- „Die IBU-API hat den Schlüssel abgelehnt (401)“ — Schlüssel falsch oder abgelaufen: neuen Schlüssel besorgen (Schritt 1).
- Prüfen Sie die Integrationsprotokolle in Gladys (
LOG_LEVEL=debug).
Die Daten gehören der IBU. Diese Integration ist nicht mit der IBU verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Biathlon IBU in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Einen IBU-API-Schlüssel erhalten | section | Nein | Das IBU-Datacenter (biathlonresults.com) benötigt einen API-Schlüssel. Fordern Sie bei der IBU einen persönlichen Schlüssel an oder verwenden Sie den Schlüssel der öffentlichen Website: Öffnen Sie biathlonresults.com in einem Desktop-Browser, drücken Sie F12, öffnen Sie den Tab Netzwerk, laden Sie die Seite neu, klicken Sie auf eine Anfrage an „sportapi“ und kopieren Sie den Wert ihres Headers „apikey“. Details in der Dokumentation. |
| IBU-API-Schlüssel | secret | Ja | Wird nur an biathlonresults.com gesendet, im Header „apikey“. |
| Verfolgte Athleten | string | Nein | IBU-IDs durch Kommas getrennt (höchstens 20). Verwenden Sie die Schaltfläche „Athlet suchen“ unten. |
| Wettkampfebene | select | Nein | |
| Sprache der Gerätetexte | select | Nein | Widgets folgen der Sprache jedes Benutzers; Gerätezustände und Szenenvariablen verwenden diese. |
| Zeitzone | string | Nein | IANA-Zeitzone der angezeigten Startzeiten. |
| Aktualisierungsintervall (Min.) | number | Nein | Wie oft die IBU-Daten gelesen werden, in Minuten (mindestens 5). |
| Rennerinnerung (Min.) | number | Nein | Minuten vor dem Start, zu denen der Auslöser „Rennen startet bald“ auslöst. |
So installierst du Biathlon IBU in Gladys
- Öffne in Gladys Integrationen: Biathlon IBU erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/gboulvin/gladys-ibu:1.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/gboulvin/Gladys-IBU.
Biathlon IBU benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Biathlon IBU ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von gboulvin veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation