Skip to content

[Feature Request] - Support des Webhooks v1 et de la limite de pooling de l'API (mars 2027) #109

Open

Description

@AuroreVgn

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

Mail reçu :
Image

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/v1 et DELETE /webhooks/v1.

  • Les événements comprennent notamment device_event, home_event_changed et topology_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 :

  1. Ajouter la prise en charge des abonnements individuels via /webhooks/v1.
  2. Ajouter des fonctions facultatives pour interpréter les événements device_event et les autres types pris en charge.
  3. Documenter l'utilisation des webhooks afin de réduire les appels API inutiles.
  4. Améliorer, si nécessaire, la gestion des réponses HTTP 429.
  5. 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions