Integración domótica Biathlon IBU, gratuita y de código abierto

Biatlón IBU: próximas carreras, clasificaciones, resultados y estadísticas de tiro.
Siga el biatlón en Gladys con los datos oficiales de la Unión Internacional de Biatlón (datacenter de la IBU, los datos de biathlonresults.com): fechas y horas de las próximas carreras, clasificaciones de la Copa del Mundo / IBU Cup, resultados y estadísticas de tiro de sus atletas favoritos.
Es una integración cloud: los datos vienen de Internet, nada se ejecuta en su red local.
1. Obtener una clave de API de la IBU
El datacenter de la IBU solo responde a las peticiones con una clave de API
(cabecera apikey). Dos maneras de obtenerla:
-
Una clave personal — pida a la IBU acceso a la API de su datacenter (ver biathlonworld.com). Es la opción más limpia.
-
La clave del sitio público — biathlonresults.com envía una clave en cada petición de su navegador. Para leerla:
- abra https://www.biathlonresults.com en un navegador de escritorio;
- pulse F12 y abra la pestaña Red;
- recargue la página (F5);
- escriba
sportapien el filtro y haga clic en una petición (Events,Competitions…); - en Encabezados → Encabezados de solicitud, copie el valor de
apikey.
Esta clave pertenece al sitio de la IBU y puede cambiar en cualquier momento: si la integración indica «La API de la IBU rechazó la clave (401)», vuelva a leerla. Úsela con moderación y solo para uso personal.
Gladys guarda la clave como secreto; solo se envía a biathlonresults.com y nunca se escribe en los registros.
2. Configurar la integración
- Abra la pestaña Configuración de la integración.
- Pegue la clave de API de la IBU y pulse Probar la conexión IBU.
- Atletas seguidos: pulse Buscar un atleta, escriba un apellido y copie el IBU ID mostrado en el campo. Separe varios ID con comas (20 como máximo).
- Elija el nivel de competición (Copa del Mundo por defecto), el idioma de los textos, su zona horaria, el intervalo de actualización (15 minutos por defecto, mínimo 5) y el aviso antes de carrera (30 minutos por defecto).
- Guarde: los dispositivos aparecen en la pestaña Descubrimiento.
Dispositivos
- Calendario de biatlón — próxima carrera (nombre, sede, fecha y hora), minutos hasta la próxima carrera, último ganador.
- Clasificación de biatlón — Hombres / Mujeres — líder de la general y sus puntos.
- Biatleta nombre (uno por atleta seguido) — puesto y puntos en la general, precisión de tiro de la temporada (total, tendido, de pie, en %), puesto y resultado de la última carrera.
La precisión se calcula sobre las carreras individuales de la temporada (sprint, persecución, individual, salida en masa), 5 blancos por tirada. Los relevos quedan excluidos (cartuchos de reserva).
Widgets del panel
- Próximas carreras de biatlón — fecha y hora, un aviso poco antes de la salida y EN DIRECTO durante la carrera.
- Clasificación de biatlón — general, sprint, persecución, individual, salida en masa o copa de naciones, podio, top 5 o top 10, atletas seguidos en verde.
- Biatleta — un atleta seguido, elegido escribiendo parte de su nombre o su IBU ID (vacío: el primer atleta seguido): puesto, puntos, precisión de tiro, tendido y de pie, última carrera.
- Últimos resultados de biatlón — podio de la última carrera y puestos de los atletas seguidos.
Escenas
Disparadores: Carrera de biatlón a punto de empezar, Resultados de una carrera de biatlón, Resultado de un atleta seguido, Nuevo líder de la general. Acciones: Obtener la próxima carrera de biatlón, Obtener las estadísticas de un atleta, Obtener el líder de una clasificación, Actualizar los datos de biatlón. Las variables se describen en la documentación en inglés.
Solución de problemas
- «La API de la IBU rechazó la clave (401)» — clave incorrecta o caducada: obtenga una nueva (paso 1).
- Consulte los registros de la integración en Gladys (
LOG_LEVEL=debug).
Los datos pertenecen a la IBU. Esta integración no está afiliada a la IBU.
Parámetros de configuración
Estos son los parámetros que Biathlon IBU te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Obtener una clave de API de la IBU | section | No | El datacenter de la IBU (biathlonresults.com) exige una clave de API. Pida una clave personal a la IBU, o reutilice la clave del sitio público: abra biathlonresults.com en un navegador de escritorio, pulse F12, abra la pestaña Red, recargue la página, haga clic en una petición a «sportapi» y copie el valor de su cabecera «apikey». Detalles en la documentación. |
| Clave de API de la IBU | secret | Sí | Se envía solo a biathlonresults.com, en la cabecera «apikey». |
| Atletas seguidos | string | No | IBU ID separados por comas (20 como máximo). Use el botón «Buscar un atleta» de abajo para obtenerlos. |
| Nivel de competición | select | No | |
| Idioma de los textos de los dispositivos | select | No | Los widgets siguen el idioma de cada usuario; los estados y las variables de escena usan este. |
| Zona horaria | string | No | Zona horaria IANA de las horas de salida mostradas. |
| Intervalo de actualización (min) | number | No | Frecuencia de lectura de los datos de la IBU, en minutos (mínimo 5). |
| Aviso antes de carrera (min) | number | No | Minutos antes de la salida en que se activa el disparador «Carrera a punto de empezar». |
Cómo instalar Biathlon IBU en Gladys
- En Gladys, abre Integraciones: Biathlon IBU aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/gboulvin/gladys-ibu:1.1.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/gboulvin/Gladys-IBU.
Biathlon IBU requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Biathlon IBU es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene gboulvin, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación