Externe Integration - Withings

Entwicklung
1

Hallo zusammen :waving_hand:

Ich stelle euch eine neue Withings-Externintegration für Gladys vor. Sie holt die Daten eurer Withings-Waagen, Blutdruckmessgeräte, Uhren und Sleep Analyzer und macht sie in den Dashboards und Szenen nutzbar.

Was sie kann

Ein Gerät „Withings Health“, das eure Daten zusammenfasst:

  • Gewicht und Körperzusammensetzung (Fettmasse, Muskeln, Knochen, Wasser, viszerales Fett);
  • Blutdruck und Puls;
  • Sauerstoffgehalt im Blut (SpO2), Körpertemperatur;
  • Schritte, Distanz, Höhenmeter und Kalorien des Tages;
  • Schlaf der letzten Nacht (Dauer, Tief-/Leicht-/REM-Schlaf, Score, Aufwachvorgänge);
  • „Im Bett“-Status mit einem Sleep Analyzer.

Die Funktionen passen sich an, was ihr wirklich messt: Mit nur einem Blutdruckmessgerät habt ihr keine zwanzig leere Felder für die Körperzusammensetzung.

Jede Messung wird am richtigen Datum gespeichert: Eine eine Stunde später synchronisierte Wägung wird im Verlauf an die richtige Stelle gesetzt.

Ein Gerät pro Withings-Gerät mit Batterie, mit einem „Batterie schwach“-Alarm.

Szenen (Gladys 5.1+)

Auslöser:

  • Neue Withings-Messung (filterbar: Wägung, Blutdruck, Temperatur, Sauerstoff…);
  • „Hinlegen“ / „Aufstehen“ (Sleep Analyzer);
  • Nachtzusammenfassung verfügbar;
  • Schrittziel erreicht (einmal pro Tag, einstellbares Ziel).

Aktionen:

  • Withings-Daten aktualisieren;
  • Letzten Withings-Wert lesen (Gewicht, Blutdruck, Schlaf…), um ihn im weiteren Verlauf der Szene zu verwenden.

Beispiel: Wenn eine Wägung eintrifft, mir „Gewicht: {{triggerEvent.data.weight}} kg“ senden.

Dashboard-Widgets

  • Withings-Gesundheit: Gewicht, Schritte, Schlaf, Blutdruck in Echtzeit, letzte Messung, Batteriezustand und ein „Aktualisieren“-Button;
  • Gewichtsverlauf: Die Kurve über eine Woche, einen Monat, drei Monate oder ein Jahr.

Echtzeit mit Gladys Plus

  • Ohne Gladys Plus: Withings wird alle 30 Minuten gelesen (einstellbar von 5 min bis 24 h).
  • Mit Gladys Plus: Withings benachrichtigt Gladys, sobald eine Daten ankommt, die Messungen sind in wenigen Sekunden da. Die Ereignisse „Hinlegen“ / „Aufstehen“ des Sleep Analyzers funktionieren nur mit Gladys Plus.

Was ihr braucht

  • Gladys 5.1 oder neuer;
  • ein Withings-Konto, mit euren Geräten synchronisiert in der Withings-App;
  • eine Withings-Entwickler-App (kostenlos, 5 Minuten zur Erstellung auf developer.withings.com). Sie liefert die Client-ID und das Client Secret, die in Gladys eingefügt werden müssen.

Kurzanleitung zur Installation

  1. Erstellt eure App auf developer.withings.com (Typ Public API integration).
  2. Fügt die Client-ID und das Client Secret in die Konfiguration der Integration ein und speichert.
  3. Klickt auf Verbinden. Beim ersten Mal lehnt Withings die Rückgabeseite ab: Das ist normal. Klickt auf Verbindung testen, kopiert die angezeigte URL und fügt sie in eure Withings-App ein.
  4. Klickt erneut auf Verbinden. Die Geräte erscheinen im Tab Entdeckung.

Die Schritt-für-Schritt-Anleitung (FR, EN, DE, ES) ist hier: gladys-withings/docs/de.md at main · prohand/gladys-withings · GitHub

Datenschutz

  • Die Daten gehen vom Withings-Cloud direkt zu eurer Gladys, über eure Entwickler-App.
  • Gladys Plus leitet nur die Benachrichtigungen „neue Daten“ weiter, ohne irgendwelche Messungen.
  • Das Client Secret und die Tokens werden nie angezeigt oder in den Logs geschrieben.

Links

Es ist eine erste Version: Euer Feedback ist willkommen, besonders wenn ihr Geräte habt, die ich nicht testen konnte (Body Scan, ScanWatch, Thermo, BPM Core…). Teilt gerne eure Szenen! :slightly_smiling_face: