Integración domótica Air France-KLM, gratuita y de código abierto
Siga sus vuelos de Air France y KLM: estado, retrasos, puerta, cinta, escenas.
Publicado por William-De71
- Dispositivos
- Versión 0.1.0
- Requiere Gladys >=5.3.0
- ★ 0
Presentación
Esta integración sigue sus vuelos de Air France y KLM (y los de los socios que publica Air France-KLM: Transavia, HOP!, Delta…) en Gladys. Usted indica un vuelo — «AF1234, mañana» — y se convierte en un dispositivo: su estado (a tiempo, retrasado, en vuelo, aterrizado, cancelado, desviado), la hora de salida y de llegada con la terminal, la puerta y la cinta de equipaje, y los retrasos en minutos. Tres disparadores de escena le avisan cuando cambia el estado, cuando el retraso cambia 15 minutos o más y cuando se anuncia o cambia la puerta. Dos widgets muestran un vuelo y todos sus vuelos.
Los datos vienen de la API oficial Flight Status de Air France-KLM, con la clave gratuita de su propia aplicación en el portal de desarrolladores. Un vuelo se publica unos días antes de su salida; hasta entonces aparece «Aún no publicado» y la integración lo vuelve a leer con regularidad.
Es una integración en la nube: llama a api.airfranceklm.com. Solo se envían allí los números y las fechas de sus vuelos.
Integración comunitaria, no afiliada a Air France ni a KLM.
Requisitos
- Gladys Assistant 5.3.0 o posterior.
- Una clave gratuita de la API Flight Status:
- cree una cuenta en developer.airfranceklm.com;
- cree una aplicación («My Apps») y suscríbala a la API Flight Status;
- copie su clave (no el secreto). Mientras la aplicación no esté activa, la API responde «Developer Inactive».
Configuración
| Campo / botón | Función |
|---|---|
| Clave de API | La clave de su aplicación Air France-KLM. |
| Consultas al día como máximo | 100 en el plan gratuito. Auméntelo solo si su plan lo permite. |
| Idioma de los textos | Nombres de los dispositivos, estados, resúmenes de escenas y motivos de la aerolínea. Automático: el idioma del panel. |
| Probar la conexión | Lee un vuelo para comprobar la clave e indica las consultas usadas hoy. |
| Seguir un vuelo | Número de vuelo (AF1234, KL 1008), fecha de salida (06/11, mañana, +3) y, para un vuelo con escala, los aeropuertos donde embarca y baja. |
| Dejar de seguir un vuelo | Su número en Listar los vuelos, o su número de vuelo. Su dispositivo permanece hasta que lo elimine. |
| Listar los vuelos | Los vuelos en seguimiento, numerados, con su trayecto y estado, y las consultas del día. |
Escalas. AF28 va de París a Papeete pasando por Los Ángeles. Sin aeropuerto, sigue el vuelo completo; con Aeropuerto de llegada LAX, solo París → Los Ángeles; con Aeropuerto de embarque LAX, solo Los Ángeles → Papeete (la fecha puede ser la de su tramo).
Hasta 10 vuelos. Se guardan en la configuración de Gladys y siguen sus copias de seguridad. Un vuelo sale de la lista 3 días después de su fecha; su dispositivo permanece.
Uso
Dispositivos
En la pestaña Descubrimiento, cree el dispositivo Vuelo AF1234 CDG → NCE · 06/11. Tiene cinco funciones:
- Estado del vuelo: A tiempo, Retrasado, En vuelo, Aterrizado, Cancelado, Desviado o Aún no publicado;
- Salida: «14:35 (prevista 14:05) · CDG T2F · puerta F42», en la hora local del aeropuerto;
- Llegada: «16:10 · NCE T2 · cinta 5», con «(+1)» cuando el avión aterriza al día siguiente;
- Retraso en la salida y Retraso en la llegada, en minutos (negativos si se adelanta), para sus condiciones de escena.
Widgets del panel
- Vuelo: el vuelo elegido, con sus horas de salida y llegada, la puerta (la cinta de equipaje una vez aterrizado), el estado, el retraso, los horarios previstos, las terminales, el avión y el motivo de un retraso o una cancelación dado por la aerolínea.
- Mis vuelos: todos los vuelos en seguimiento con su estado (o su retraso) y las consultas usadas hoy.
Escenas
Disparadores (la primera lectura de un vuelo solo sirve de referencia):
- Estado del vuelo cambiado: retrasado, despegó, aterrizó, cancelado o desviado. El filtro Nuevo estado conserva un solo estado. Variables:
status,previous_status,departure_time,arrival_time,gate,delay,reason,summary… - Retraso del vuelo cambiado: el retraso cambió 15 minutos o más (el de la salida hasta el despegue, el de la llegada después). Variables:
delay,previous_delay,summary… - Puerta anunciada o cambiada: variables
gate,previous_gate,terminal,summary.
Acciones:
- Leer un vuelo en seguimiento: estado, horas, retrasos, puerta, cinta, avión, motivo y un
summary; se vuelve a leer si tiene más de 10 minutos. - Consultar un vuelo: cualquier vuelo en una fecha, sin seguirlo (una consulta, guardada 15 minutos).
Ejemplos:
- Cuando el estado de «Vuelo AF1234» pasa a Retrasado → enviar
{{triggerEvent.data.summary}}a su teléfono. - Cuando el vuelo de vuelta pasa a Aterrizado → encender la calefacción y la luz de la entrada.
- Cuando se anuncia la puerta → hacer decir «Puerta
{{triggerEvent.data.gate}}» al altavoz.
Transporte y cuota
Solo en la nube. El plan gratuito permite 100 consultas al día y una por segundo: la integración lee cada vuelo con más frecuencia a medida que se acerca la salida:
- cada 12 h mientras no está publicado (cada 2 h a menos de 3 días);
- cada 6 h a más de 24 h de la salida, luego cada 2 h, cada 30 min en las 6 últimas horas y cada 15 min en las 2 últimas;
- en vuelo, cada 30 min, luego cada 15 min en la hora antes del aterrizaje;
- nunca más una vez aterrizado o cancelado.
Cuente unas 30 consultas por vuelo el día de la salida. Las lecturas automáticas se detienen 5 consultas antes del límite, para que las pruebas y las acciones de escena sigan funcionando. El contador vuelve a empezar a medianoche (UTC) y sobrevive a los reinicios.
Solución de problemas
- «Clave rechazada (HTTP 403: Developer Inactive)»: la clave es incorrecta, o la aplicación aún no está activa o no está suscrita a Flight Status en el portal.
- «Aún no publicado»: Air France-KLM publica los vuelos unos días antes de la salida. Compruebe también el número y la fecha (la de salida, en hora local).
- «Límite diario alcanzado»: los vuelos se volverán a leer después de medianoche (UTC). Siga menos vuelos el mismo día, o aumente el límite si su plan lo permite.
- «Air France-KLM rechaza más consultas»: la cuota de la clave está agotada del lado de Air France-KLM; la integración espera una hora antes de volver a intentarlo.
- Los motivos de retraso están en inglés: la aerolínea no los publica en todos los idiomas.
- Para informar de un problema: copie las respuestas de Probar la conexión y Listar los vuelos en una issue de GitHub o una respuesta en el foro, con las versiones de Gladys y de la integración.
Parámetros de configuración
Estos son los parámetros que Air France-KLM te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Clave de desarrollador de Air France-KLM | section | No | Esta integración lee la API oficial Flight Status de Air France-KLM con su propia clave gratuita. 1. Cree una cuenta en developer.airfranceklm.com y una aplicación suscrita a la API Flight Status. 2. Pegue su clave abajo y guarde. 3. Pulse «Seguir un vuelo» (AF1234, mañana) y añada su dispositivo en la pestaña Descubrimiento. La clave gratuita permite 100 consultas al día: la integración lee cada vuelo con más frecuencia a medida que se acerca la salida (unas 30 consultas para un vuelo el mismo día). |
| Clave de API | secret | Sí | La clave de su aplicación en developer.airfranceklm.com (no el secreto). |
| Consultas al día como máximo | number | No | 100 en el plan gratuito. Auméntelo solo si su plan lo permite. |
| Idioma de los textos | select | No | Nombres de los dispositivos, estados, resúmenes de escenas y motivos de la aerolínea. Automático: el idioma del panel. |
Cómo instalar Air France-KLM en Gladys
- En Gladys, abre Integraciones: Air France-KLM 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/william-de71/gladys-air-france-klm:0.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/William-De71/gladys-air-france-klm.
Air France-KLM requiere Gladys >=5.3.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
Air France-KLM 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 William-De71, 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