Repository navigation
Description
Bonjour @philippelt
Netatmo a annoncé la mise en service d'un nouveau système de webhooks à partir du 4 novembre 2026, ainsi qu'une réduction prévue des quotas d'appels API à compter du 1er mars 2027.
Je souhaitais demander une évolution de lnetatmo pour prendre en charge cette nouvelle API et anticiper les changements annoncés.
Documentation officielle : https://dev.netatmo.com/apidocumentation/webhooks
Qu'est-ce qui change ?
Le nouveau service de webhooks permet de recevoir les changements d'état des équipements par des notifications HTTP POST, afin de limiter les interrogations régulières de l'API.
D'après la documentation Netatmo :
-
Les webhooks sont disponibles pour certaines passerelles Netatmo, Legrand et BTicino.
-
Les abonnements par utilisateur utilisent
POST /webhooks/v1etDELETE /webhooks/v1. -
Les événements comprennent notamment
device_event,home_event_changedettopology_changed. -
Les événements des équipements peuvent contenir leurs nouvelles données ainsi qu'un
sequence_id. -
Les événements peuvent être reçus plusieurs fois, arriver dans le désordre ou être perdus pendant une suspension temporaire du service.
Les scopes actuellement annoncés comprennent notamment read_station, read_thermostat, read_smarther, read_magellan, read_mhs1, read_hybrid et read_mx.
Impact potentiel sur lnetatmo
D'après l'examen du code actuel, lnetatmo repose principalement sur des appels à l'API REST pour récupérer les informations des équipements.
La bibliothèque ne semble pas encore intégrer les nouveaux endpoints d'abonnement ni le traitement des événements webhook.
Les scripts existants devraient continuer à fonctionner pendant la période de migration, mais ceux effectuant des interrogations fréquentes pourraient rencontrer davantage de limitations à partir du 1er mars 2027.
Évolutions proposées
Serait-il envisageable de :
- Ajouter la prise en charge des abonnements individuels via
/webhooks/v1. - Ajouter des fonctions facultatives pour interpréter les événements
device_eventet les autres types pris en charge. - Documenter l'utilisation des webhooks afin de réduire les appels API inutiles.
- Améliorer, si nécessaire, la gestion des réponses HTTP 429.
- Préserver intégralement la compatibilité des fonctions REST et des scripts existants.
Il me semblerait préférable que les webhooks restent facultatifs, afin que les utilisateurs puissent continuer à employer les fonctions REST sans devoir installer de serveur HTTP.
Le maintien d'une synchronisation périodique de secours paraît également important, puisque Netatmo indique que certains événements peuvent être perdus pendant une suspension des livraisons.
Priorité : éviter les interruptions de service
Ma principale préoccupation concerne la continuité de fonctionnement des installations domotiques (dont la mienne) utilisant cette bibliothèque.
L'idéal serait de pouvoir effectuer une migration progressive, sans casser les scripts existants, l'authentification ou le pilotage des équipements.
Je comprends que ces évolutions puissent demander du travail, mais il me semblait utile d'anticiper les changements avant mars 2027.
Merci pour le maintien de cette bibliothèque et pour tout le travail réalisé !

Activity