Intégration domotique Air France-KLM, gratuite et open source
Suivez vos vols Air France et KLM : statut, retards, porte, tapis bagages, scènes.
Publiée par William-De71
- Appareils
- Version 0.1.0
- Nécessite Gladys >=5.3.0
- ★ 0
Présentation
Cette intégration suit vos vols Air France et KLM (et ceux des partenaires que publie Air France-KLM : Transavia, HOP!, Delta…) dans Gladys. Vous déclarez un vol — « AF1234, demain » — et il devient un appareil : son statut (à l’heure, retardé, en vol, arrivé, annulé, dérouté), l’heure de départ et d’arrivée avec le terminal, la porte et le tapis à bagages, et les retards en minutes. Trois déclencheurs de scène vous préviennent quand le statut change, quand le retard bouge de 15 minutes ou plus, et quand la porte est annoncée ou change. Deux widgets affichent un vol et tous vos vols.
Les données viennent de l’API officielle Flight Status d’Air France-KLM, avec la clé gratuite de votre propre application sur le portail développeur. Un vol est publié quelques jours avant son départ ; avant, il apparaît « Non publié » et l’intégration le relit régulièrement.
C’est une intégration cloud : elle contacte api.airfranceklm.com. Seuls les numéros et dates de vos vols y sont envoyés.
Intégration communautaire, non affiliée à Air France ni à KLM.
Prérequis
- Gladys Assistant 5.3.0 ou plus récent.
- Une clé de l’API Flight Status, gratuite :
- créez un compte sur developer.airfranceklm.com ;
- créez une application (« My Apps ») et abonnez-la à l’API Flight Status ;
- copiez sa clé (pas le secret). Tant que l’application n’est pas active, l’API répond « Developer Inactive ».
Configuration
| Champ / bouton | Rôle |
|---|---|
| Clé d’API | La clé de votre application Air France-KLM. |
| Requêtes par jour au maximum | 100 avec l’offre gratuite. Ne l’augmentez que si votre offre le permet. |
| Langue des textes | Noms des appareils, statuts, résumés des scènes et motifs donnés par la compagnie. Automatique : la langue du tableau de bord. |
| Tester la connexion | Lit un vol pour vérifier la clé, et donne les requêtes utilisées aujourd’hui. |
| Suivre un vol | Numéro de vol (AF1234, KL 1008), date de départ (06/11, demain, +3) et, pour un vol avec escale, l’aéroport où vous embarquez et descendez. |
| Ne plus suivre un vol | Son numéro dans Lister les vols, ou son numéro de vol. Son appareil reste jusqu’à ce que vous le supprimiez. |
| Lister les vols | Les vols suivis, numérotés, avec leur trajet et leur statut, et les requêtes du jour. |
Escales. AF28 va de Paris à Papeete en passant par Los Angeles. Sans aéroport, vous suivez tout le vol ; avec Aéroport d’arrivée LAX, seulement Paris → Los Angeles ; avec Aéroport d’embarquement LAX, seulement Los Angeles → Papeete (la date peut être celle de votre étape).
Jusqu’à 10 vols. Ils sont gardés dans la configuration de Gladys et suivent ses sauvegardes. Un vol disparaît de la liste 3 jours après sa date ; son appareil reste.
Utilisation
Appareils
Dans l’onglet Découverte, créez l’appareil Vol AF1234 CDG → NCE · 06/11. Il a cinq fonctionnalités :
- Statut du vol : À l’heure, Retardé, En vol, Arrivé, Annulé, Dérouté ou Non publié ;
- Départ : « 14:35 (prévu 14:05) · CDG T2F · porte F42 », à l’heure locale de l’aéroport ;
- Arrivée : « 16:10 · NCE T2 · tapis 5 », avec « (+1) » quand l’avion se pose le lendemain ;
- Retard au départ et Retard à l’arrivée, en minutes (négatifs en cas d’avance), pour vos conditions de scène.
Widgets du tableau de bord
- Vol : le vol choisi, avec ses heures de départ et d’arrivée, la porte (le tapis à bagages une fois arrivé), le statut, le retard, les horaires prévus, les terminaux, l’avion, et le motif d’un retard ou d’une annulation donné par la compagnie.
- Mes vols : tous les vols suivis avec leur statut (ou leur retard), et les requêtes utilisées aujourd’hui.
Scènes
Déclencheurs (la première lecture d’un vol ne sert que de référence) :
- Statut du vol modifié : retardé, décollé, arrivé, annulé ou dérouté. Le filtre Nouveau statut ne garde qu’un statut. Variables :
status,previous_status,departure_time,arrival_time,gate,delay,reason,summary… - Retard du vol modifié : le retard a bougé de 15 minutes ou plus (celui du départ jusqu’au décollage, celui de l’arrivée ensuite). Variables :
delay,previous_delay,summary… - Porte annoncée ou changée : variables
gate,previous_gate,terminal,summary.
Actions :
- Lire un vol suivi : statut, heures, retards, porte, tapis à bagages, avion, motif et un
summary; relu s’il date de plus de 10 minutes. - Rechercher un vol : n’importe quel vol à une date, sans le suivre (une requête, gardée 15 minutes).
Exemples :
- Quand le statut de « Vol AF1234 » passe à Retardé → envoyer
{{triggerEvent.data.summary}}sur votre téléphone. - Quand le vol de retour passe à Arrivé → allumer le chauffage et l’entrée.
- Quand la porte est annoncée → faire dire « Porte
{{triggerEvent.data.gate}}» par l’enceinte.
Transport et quota
Cloud uniquement. L’offre gratuite permet 100 requêtes par jour et une par seconde : l’intégration lit chaque vol plus souvent à l’approche du départ :
- toutes les 12 h tant qu’il n’est pas publié (toutes les 2 h à moins de 3 jours) ;
- toutes les 6 h plus de 24 h avant le départ, puis toutes les 2 h, toutes les 30 min dans les 6 dernières heures et toutes les 15 min dans les 2 dernières ;
- en vol, toutes les 30 min, puis toutes les 15 min dans l’heure avant l’atterrissage ;
- plus du tout une fois arrivé ou annulé.
Comptez environ 30 requêtes par vol le jour J. Les lectures automatiques s’arrêtent 5 requêtes avant la limite, pour laisser passer les tests et les actions de scène. Le compteur repart à minuit (UTC) et survit aux redémarrages.
Dépannage
- « Clé refusée (HTTP 403: Developer Inactive) » : la clé est fausse, ou l’application n’est pas encore active ou pas abonnée à Flight Status sur le portail.
- « Non publié » : Air France-KLM publie les vols quelques jours avant le départ. Vérifiez aussi le numéro et la date (celle du départ, en heure locale).
- « Limite quotidienne atteinte » : les vols seront relus après minuit (UTC). Suivez moins de vols le même jour, ou relevez la limite si votre offre le permet.
- « Air France-KLM refuse d’autres requêtes » : le quota de la clé est épuisé côté Air France-KLM ; l’intégration attend une heure avant de réessayer.
- Les motifs de retard sont en anglais : la compagnie ne les publie pas dans toutes les langues.
- Pour signaler un problème : copiez les réponses de Tester la connexion et Lister les vols dans une issue GitHub ou une réponse sur le forum, avec les versions de Gladys et de l’intégration.
Paramètres de configuration
Voici les paramètres demandés par Air France-KLM dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Clé développeur Air France-KLM | section | Non | Cette intégration lit l’API officielle Flight Status d’Air France-KLM avec votre propre clé gratuite. 1. Créez un compte sur developer.airfranceklm.com, puis une application abonnée à l’API Flight Status. 2. Collez sa clé ci-dessous et enregistrez. 3. Appuyez sur « Suivre un vol » (AF1234, demain), puis ajoutez son appareil dans l’onglet Découverte. La clé gratuite permet 100 requêtes par jour : l’intégration lit chaque vol plus souvent à l’approche du départ (environ 30 requêtes pour un vol le jour J). |
| Clé d’API | secret | Oui | La clé de votre application sur developer.airfranceklm.com (pas le secret). |
| Requêtes par jour au maximum | number | Non | 100 avec l’offre gratuite. Ne l’augmentez que si votre offre le permet. |
| Langue des textes | select | Non | Noms des appareils, statuts, résumés des scènes et motifs donnés par la compagnie. Automatique : la langue du tableau de bord. |
Comment installer Air France-KLM dans Gladys
- Dans Gladys, ouvrez Intégrations : Air France-KLM 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/william-de71/gladys-air-france-klm:0.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/William-De71/gladys-air-france-klm.
Air France-KLM nécessite Gladys >=5.3.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
Air France-KLM 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 William-De71, 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