Hilfezentrum HealthyApps
Deutsch
Hilfezentrum
Hauptwebsite ↗

Hilfethemen suchen

Apple-Health-Daten mit REST-API synchronisieren

Sende Gesundheitsdaten an einen REST-API-Endpoint.

Zuletzt aktualisiert: 31. Oktober 2026

Auf dieser Seite
Automation öffnenName, Status und BenachrichtigungenEndpoint einrichten
Einstellungen zum Datentyp Einstellungen zum Datentyp GesundheitsmetrikenWorkouts
Exporteinstellungen Exporteinstellungen ExportformatExportversionDatumsbereichDaten zusammenfassen und Zeitgruppierung
Batch-Anfragen und große NutzlastenErinnerungen planenSynchronisierungsfrequenz und speichernAnfrage-HeaderHistorische oder verpasste Daten exportierenFehlerbehebung

Sende Gesundheitsexporte an einen Endpoint, der HTTP-POST-Anfragen akzeptiert.

Wichtig — Einschränkungen der Automationen: Das Gerät muss entsperrt sein, um Gesundheitsdaten zu lesen, und iOS garantiert keine Hintergrundausführungen mit der von dir gewählten Frequenz. Lies die Einschränkungen der Automationen, bevor du dich auf automatische Exporte verlässt.

Automation öffnen

Öffne Exportieren → Automatisiert auf dem iPhone oder Automationen in der Seitenleiste des iPad. Wähle Neue Automation oder öffne eine bestehende zum Bearbeiten.

Name, Status und Benachrichtigungen

Gib einen Namen ein, der diese Automation identifiziert. Aktiviert erlaubt automatische Ausführungen; lasse es ausgeschaltet, bis du bereit bist.

Wähle die Ausführungsbenachrichtigungen, die du möchtest:

  • Bei Cache-Aktualisierung benachrichtigen zeigt an, dass Exportdaten vorbereitet wurden.
  • Bei Ausführung benachrichtigen zeigt einen erfolgreichen Upload an deinen Endpoint an.

Erlaube Benachrichtigungen, wenn du dazu aufgefordert wirst. Diese Benachrichtigungen melden Aktivität; sie planen keine Ausführung.

Endpoint einrichten

  1. Wähle REST-API als Automationstyp.
  2. Gib eine von deinem iPhone oder iPad erreichbare URL ein, z. B. https://api.example.com/health-data.
  3. Füge die erforderliche Authentifizierung unter HTTP-Header hinzu. Verwende z. B. Authorization als Schlüssel und Bearer YOUR_TOKEN als Wert.
  4. Wähle ein Anfrage-Timeout, das zu deinem Endpoint passt.

Jeder Header braucht Schlüssel und Wert. Für einen Server auf einem anderen Gerät verwende seine erreichbare Netzwerkadresse statt localhost.

Einstellungen zum Datentyp

Wähle einen Datentyp für diese Automation: Gesundheitsmetriken, Workouts, Symptome, ECG, Herzfrequenzbenachrichtigungen, Gemütszustand, Zyklusverfolgung oder Medikamente. Gemütszustand erfordert iOS 18 oder neuer; Medikamente erfordern iOS 26 oder neuer und separaten Medikamentenzugriff.

Gesundheitsmetriken

Wähle Gesundheitsmetriken, öffne Gesundheitsmetriken auswählen und wähle die benötigten Messungen.

Um Messwerte auf bestimmte Apps oder Geräte zu beschränken, öffne Bevorzugte Quellen, wähle eine Metrik und ihre Quellen. Alle erlaubt alle Quellen, die nicht ausgeschlossen wurden. Verwende Ausgeschlossene Quellen, um eine Quelle für die Gesundheitsmetriken dieser Automation zu ignorieren. Ausschlüsse haben Vorrang; eine nicht ausgewählte Quelle wird nicht ersetzt, wenn die bevorzugte keine Daten hat. Wähle Sichern, um die Quellenoptionen anzuwenden, oder Abbrechen, um sie zu verwerfen.

Workouts

Wähle Workouts, um Workout-Datensätze zu exportieren. Routendaten einbeziehen fügt verfügbare Routenpunkte zu den JSON-Workout-Daten hinzu. Es erstellt keine separaten GPX-Dateien.

Für Version 2 aktiviere Workout-Metriken einbeziehen, um Messwerte wie Herzfrequenz, aktive Energie und Schritte hinzuzufügen. Wähle Minuten oder Sekunden für die Zeitgruppierung der Workout-Metriken; Sekunden erzeugen mehr Detail und größere Exporte. Version 1 enthält immer Workout-Metriken.

Exporteinstellungen

Exportformat

  • JSON bewahrt strukturierte Daten für Integrationen und Analysen.
  • CSV erstellt tabellarische Dateien für Tabellenkalkulationen.
  • Markdown erstellt lesbare Überschriften und Tabellen für Notizen und Dateien.

Exportversion

Wähle Version 2 für die aktuelle Datenstruktur. Verwende Version 1, wenn ein bestehender Workflow vom älteren Format abhängt.

Datumsbereich

Auswahl Enthaltene Daten
Standard Der Vortag und heute bis zur Ausführungszeit
Seit letzter Synchronisierung Von der vorherigen Synchronisierung bis zur Ausführungszeit
Heute Heute bis zur Ausführungszeit
Gestern Der vollständige Vortag
Letzte 7 Tage Die sieben vollständigen vorherigen Tage

Daten zusammenfassen und Zeitgruppierung

Für JSON + Gesundheitsmetriken aktiviere Daten zusammenfassen, um Messwerte in Zeitgruppen zu kombinieren, oder deaktiviere es für einzelne Messwerte, wenn verfügbar. Die Zusammenfassung hängt von der Metrik ab—zum Beispiel werden Schritte addiert und Gewichtsmesswerte gemittelt. CSV-Exporte von Gesundheitsmetriken verwenden zusammengefasste Daten.

Wenn Zeitgruppierung verfügbar ist, wähle, wie viel Detail erhalten bleiben soll. Gruppen nach Stunde oder Tag erzeugen weniger Zeilen als Minuten oder Sekunden. Die verfügbaren Optionen hängen vom Datumsbereich und Format ab. Die Zeitgruppierung von Workouts wird separat unter Workouts konfiguriert.

Batch-Anfragen und große Nutzlasten

Für REST-API + JSON aktiviere Batch-Anfragen, um Daten in mehreren Anfragen zu senden. Verwende das, wenn dein Endpoint große Körper ablehnt oder große Anfragen das Timeout überschreiten. Der Empfangsdienst muss jede Anfrage separat verarbeiten.

Batches sind für CSV und Markdown nicht verfügbar. Sie verringern die Größe jeder Anfrage, aber nicht die Menge der Gesundheitsdaten, die das Gerät lesen muss. Siehe Leistung, wenn die Vorbereitung langsam ist.

Erinnerungen planen

Wenn du einen Hinweis zum Entsperren und Öffnen der App möchtest, aktiviere Erinnerungen aktivieren. Wähle Stündlich, Täglich oder Ausgewählte Tage und konfiguriere Minute, Uhrzeit und Tage entsprechend. Erlaube Benachrichtigungszugriff, wenn du dazu aufgefordert wirst; bei Ablehnung verwende Benachrichtigungseinstellungen öffnen.

Eine Erinnerung führt die Automation nicht aus und bestätigt keine erfolgreiche Synchronisierung. Tippe darauf, um die Automation zu öffnen, oder verwende Öffnen und synchronisieren in der Benachrichtigung, um eine Ausführung anzufordern. Die Automation muss aktiviert sein; eine Erinnerung kann auch nach einer erfolgreichen Hintergrundausführung erscheinen. Erinnerungsänderungen gelten beim Speichern.

Synchronisierungsfrequenz und speichern

Wähle eine Zahl und Minuten, Stunden, Tage oder Wochen unter Synchronisierungsfrequenz—zum Beispiel alle 15 Minuten. Das ist eine gewünschte Hintergrundkadenz, kein garantierter Zeitplan.

Das Gerät muss entsperrt sein, wenn Gesundheitsdaten gelesen werden. Aktiviere die Hintergrundaktualisierung für Health Auto Export und deaktiviere den Energiesparmodus für automatische Ausführungen. iOS kann Ausführungen verzögern, wenn das Gerät inaktiv war oder Systemressourcen begrenzt sind.

Aktiviere Aktiviert, wenn du für automatische Ausführungen bereit bist, und wähle Aktualisieren, um die Automation zu speichern. Du kannst sofort einen Datumsbereich mit den folgenden Schritten hochladen.

Anfrage-Header

Die App setzt Content-Type für das gewählte Format und enthält:

Header Bedeutung
automation-name Name der Automation
automation-id Kennung der Automation
automation-aggregation Ausgewählte Zeitgruppierung
automation-period Ausgewählter Datumsbereich
session-id Kennung der Anfrage

Historische oder verpasste Daten exportieren

Verwende Manueller Upload bei der ersten Einrichtung der Automation, um historische Daten zu exportieren, oder später, um Daten abzudecken, die die automatische Synchronisierung nicht erreicht hat. Du kannst ihn auch verwenden, um die Konfiguration zu prüfen.

  1. Öffne die Automation und wähle Manueller Upload unter Vorhandene Daten exportieren.
  2. Lege die Daten für Start und Ende fest und wähle Export starten.
  3. Prüfe die empfangene Anfrage an deinem Endpoint, die Header und den Körper.

Fehlerbehebung

  • Keine Anfrage empfangen: Prüfe die URL, die Netzwerkerreichbarkeit und die Serverprotokolle.
  • Authentifizierungsfehler: Prüfe den Header-Schlüssel, den Token und die Endpoint-Berechtigungen.
  • Nutzlast abgelehnt oder Timeout: Prüfe die Größenlimits des Servers, verwende Batches für JSON oder verringere die Exportgröße.

Öffne die Automation und wähle Aktivitätsprotokolle anzeigen, um eine Ausführung zu prüfen. Warnungen weisen auf mögliche Probleme wie langsame Datenabfrage hin; Fehler identifizieren fehlgeschlagene Schritte. Hilfe beim Melden eines Problems unter Hilfe erhalten.