Zum Hauptinhalt springen

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

Biathlon IBU-Integration für Gladys Assistant

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:

    1. öffnen Sie https://www.biathlonresults.com in einem Desktop-Browser;
    2. drücken Sie F12 und öffnen Sie den Tab Netzwerk;
    3. laden Sie die Seite neu (F5);
    4. geben Sie sportapi in das Filterfeld ein und klicken Sie auf eine Anfrage (Events, Competitions…);
    5. 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​

  1. Öffnen Sie den Tab Konfiguration der Integration.
  2. Fügen Sie den IBU-API-Schlüssel ein und klicken Sie auf IBU-Verbindung testen.
  3. 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).
  4. 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).
  5. 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.

EinstellungTypPflichtfeldBeschreibung
Einen IBU-API-Schlüssel erhaltensectionNeinDas 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üsselsecretJaWird nur an biathlonresults.com gesendet, im Header „apikey“.
Verfolgte AthletenstringNeinIBU-IDs durch Kommas getrennt (höchstens 20). Verwenden Sie die Schaltfläche „Athlet suchen“ unten.
WettkampfebeneselectNein
Sprache der GerätetexteselectNeinWidgets folgen der Sprache jedes Benutzers; Gerätezustände und Szenenvariablen verwenden diese.
ZeitzonestringNeinIANA-Zeitzone der angezeigten Startzeiten.
Aktualisierungsintervall (Min.)numberNeinWie oft die IBU-Daten gelesen werden, in Minuten (mindestens 5).
Rennerinnerung (Min.)numberNeinMinuten vor dem Start, zu denen der Auslöser „Rennen startet bald“ auslöst.

So installierst du Biathlon IBU in Gladys​

  1. Öffne in Gladys Integrationen: Biathlon IBU erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. 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).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂