Apple Health-Daten zu REST API synchronisieren

REST API-Automatisierungen ermöglichen es Ihnen, Ihre Gesundheitsdaten automatisch an jeden Webservice zu exportieren, der HTTP POST-Anfragen akzeptiert. Dies ist ideal für die Integration mit benutzerdefinierten Backends, Drittanbieter-APIs oder Webhooks.

Übersicht

REST API-Automatisierungen senden Ihre Gesundheitsdaten an einen angegebenen URL-Endpunkt unter Verwendung von HTTP POST-Anfragen. Die Automatisierung kann Daten im JSON- oder CSV-Format senden, mit konfigurierbaren Headern für Authentifizierung und benutzerdefinierte Metadaten.

Anwendungsfälle:

• Integration mit benutzerdefinierten Backend-Services
• Senden von Daten an Webhooks
• Synchronisierung mit Drittanbieter-APIs
• Erstellen benutzerdefinierter Dashboards oder Analyseplattformen

Hauptfunktionen:

• Unterstützt sowohl JSON- als auch CSV-Formate
• Benutzerdefinierte HTTP-Header für Authentifizierung
• Konfigurierbare Anforderungs-Timeout
• Manueller Export historischer Daten

Einschränkungen

• Zugriff auf Gesundheitsdaten: Apps dürfen nicht auf Gesundheitsdaten zugreifen, während das iPhone gesperrt ist. Automatisierungen werden nur während der Zeiten ausgeführt, in denen Ihr Gerät entsperrt ist. Dies kann die Datenaktualität beeinträchtigen. Siehe Anweisungen für manuelle Synchronisierung, um Daten auf dem neuesten Stand zu halten.

• Hintergrundverarbeitung: iOS begrenzt die Hintergrundverarbeitung, um die Batterielebensdauer zu erhalten. Automatisierungen sind auf Hintergrundaktualisierung angewiesen und werden möglicherweise nicht sofort ausgeführt, wenn:

  • Hintergrundaktualisierung für die App deaktiviert ist
  • Das Gerät sich im Energiesparmodus befindet
  • Das Gerät über längere Zeiträume inaktiv war
  • Systemressourcen eingeschränkt sind
  • Mehrere Apps um Hintergrundausführungszeit konkurrieren

Voraussetzungen

• Ein gültiger URL-Endpunkt, der HTTP POST-Anfragen akzeptiert
• Authentifizierungsanmeldedaten (falls von Ihrem Endpunkt erforderlich)
• Netzwerkverbindung, um Ihren Endpunkt zu erreichen

Konfiguration

Navigieren Sie zum Bildschirm Automatisierte Exporte aus der Hauptnavigation, tippen Sie dann auf "Neue Automatisierung" und wählen Sie "REST API" als Automatisierungstyp.

Automatisierungsname

Geben Sie einen beschreibenden Namen für Ihre Automatisierung ein (z. B. "Meine Backend-API", "Webhook-Integration").

Benachrichtigungen

Konfigurieren Sie, wann Sie Benachrichtigungen erhalten möchten:

• Bei Cache-Aktualisierung benachrichtigen - Erhalten Sie eine Benachrichtigung, wenn zwischengespeicherte Daten aktualisiert werden
• Bei Ausführung benachrichtigen - Erhalten Sie eine Benachrichtigung jedes Mal, wenn die Automatisierung ausgeführt wird

URL-Konfiguration

Geben Sie die vollständige URL ein, an die Sie Ihre Gesundheitsdaten senden möchten. Dies sollte eine vollständige URL sein, einschließlich des Protokolls (http:// oder https://).

Beispiel-URLs:

• https://api.example.com/health-data
• https://webhook.site/your-unique-id
• http://localhost:3000/api/health

Hinweis: Die URL muss gültig und von Ihrem Gerät aus erreichbar sein. Ungültige URLs verhindern, dass die Automatisierung ausgeführt wird.

Anforderungs-Timeout

Wählen Sie ein Timeout-Intervall für HTTP-Anfragen. Dies bestimmt, wie lange die App auf eine Antwort wartet, bevor die Anfrage als fehlgeschlagen betrachtet wird.

HTTP-Header

Fügen Sie benutzerdefinierte HTTP-Header für Authentifizierung oder Metadaten hinzu. Häufige Anwendungsfälle umfassen:

• API-Schlüssel: X-API-Key: your-api-key
• Autorisierungstoken: Authorization: Bearer your-token
• Content-Type-Überschreibungen: Content-Type: application/json

So fügen Sie Header hinzu:

1. Tippen Sie auf "Header hinzufügen"
2. Geben Sie den Header-Schlüssel in das linke Feld ein
3. Geben Sie den Header-Wert in das rechte Feld ein
4. Wiederholen Sie dies für zusätzliche Header

Wichtig: Jeder Header-Schlüssel muss einen entsprechenden Wert haben. Leere Header werden ignoriert.

Datentyp-Einstellungen

Datentyp

Wählen Sie aus, welche Art von Gesundheitsdaten exportiert werden sollen:

• Gesundheitsmetriken - Schritte, Herzfrequenz, Schlaf und andere Gesundheitsmessungen
• Workouts - Trainings- und Fitnessaktivitäten
• Symptome - Gesundheitssymptome und -zustände
• EKG - Elektrokardiogramm-Messwerte
• Herzfrequenz-Benachrichtigungen - Hohe/niedrige Herzfrequenz-Ereignisse
• Gemütszustand - Stimmungs- und mentale Zustandseinträge (iOS 18.0+)
• Zyklusverfolgung - Menstruationszyklus- und reproduktive Gesundheitsdaten
• Medikamente - Medikamentenprotokolle und Einhaltung (iOS 26.0+)

Gesundheitsmetriken-Konfiguration

Wenn Gesundheitsmetriken ausgewählt ist:

Gesundheitsmetriken auswählen - Wählen Sie aus, welche spezifischen Metriken einbezogen werden sollen. Sie können alle verfügbaren Metriken auswählen oder spezifische auswählen.

Tipp: Die Auswahl nur der benötigten Metriken kann die Verarbeitungszeit verbessern und die Datengröße reduzieren.

Bevorzugte Quellen - Konfigurieren Sie, welche Datenquellen Priorität haben, wenn mehrere Quellen dieselbe Metrik bereitstellen.

Workout-Konfiguration

Wenn Workouts ausgewählt ist:

Routendaten einbeziehen - Aktivieren Sie, um Routen für Workouts einzuschließen, die Standortdaten haben.

Workout-Metriken einbeziehen - Aktivieren Sie, um Gesundheitsmetriken einzuschließen, die während der Workouts erfasst wurden (Herzfrequenz, Kalorien usw.).

Zeitgruppierung (Workout-Metriken) - Bei Verwendung von Export-Version 2 und wenn Workout-Metriken einbeziehen aktiviert ist:

• Minuten - Gruppiert Workout-Metriken nach Minute
• Sekunden - Gruppiert Workout-Metriken nach Sekunde

Export-Einstellungen

Export-Format

Wählen Sie das Format für Ihre exportierten Daten:

• JSON-Format - Bietet detaillierte Datenstrukturen mit verschachtelten Objekten. Am besten für APIs, Datenbanken und Anwendungen, die strukturierte Daten benötigen. Das JSON-Format enthält detailliertere Informationen für komplexe Datentypen wie Schlafphasen und AFib-Messwerte.

• CSV-Format - Bietet Tabellendaten, die einfach in Tabellenkalkulationsanwendungen importiert werden können. Am besten für einfache Datenanalyse oder wenn Ihr Endpunkt CSV-Daten erwartet.

Hinweis: Der Content-Type-Header wird automatisch auf application/json für JSON-Exporte und multipart/form-data für CSV-Exporte gesetzt.

Export-Version

Wählen Sie eine Export-Version. Die Versionsverwaltung ermöglicht es, in Ihrem eigenen Tempo zwischen aktualisierten Versionen des Exports zu wechseln und minimiert Änderungen, die Workflows beeinträchtigen.

• Version 1 - Legacy-Format, verwenden Sie es, wenn Sie vorhandene Workflows haben, die von diesem Format abhängen
• Version 2 - Aktuelles Format mit erweiterten Workout-Daten und detaillierteren Metadaten-Optionen

Datumsbereich

Wählen Sie aus, wann Daten exportiert werden sollen:

• Standard - Synchronisiert Daten für den vollständigen vorherigen Tag plus Daten bis zum aktuellen Datum und zur aktuellen Uhrzeit
• Seit letzter Synchronisierung - Bei jeder Synchronisierung werden alle Daten seit dem letzten Ausführen des Exports bis zum aktuellen Datum und zur aktuellen Uhrzeit exportiert
• Heute - Synchronisiert alle Daten für das aktuelle Datum bis zur aktuellen Uhrzeit
• Gestern - Synchronisiert alle Daten für den vollständigen vorherigen Tag
• Letzte 7 Tage - Synchronisiert Daten für die vollständigen letzten sieben Tage

Daten zusammenfassen

Wenn Sie das JSON-Format mit dem Datentyp Gesundheitsmetriken verwenden, aktivieren oder deaktivieren Sie Daten zusammenfassen.

• EIN - Bietet aggregierte Datenzusammenfassungen
• AUS - Bietet disaggregierte Daten, wo möglich, und zeigt individuelle Datenpunkte

Hinweis: Diese Einstellung gilt nur für das JSON-Format mit Gesundheitsmetriken. Daten werden immer aggregiert, wenn das CSV-Format verwendet wird oder wenn mehrere Metriken ausgewählt sind.

Zeitgruppierung

Wenn Sie das JSON-Format mit aktiviertem Daten zusammenfassen verwenden, wählen Sie aus, wie Daten aggregiert werden sollen.

Hinweis: Das CSV-Format aggregiert immer Daten. Die Aggregation auf Minuten- und Sekundenebene kann die Verarbeitungszeit und Datengröße erheblich erhöhen.

Batch-Anfragen

Wenn Sie das JSON-Format verwenden, aktivieren Sie Batch-Anfragen, um Daten in Batches über mehrere Anfragen anstatt einer einzelnen Nutzlast zu senden.

• EIN - Verteilt Daten über mehrere Anfragen, um übermäßig große Nutzlasten zu vermeiden
• AUS - Sendet alle Daten in einer einzelnen Anfrage

Synchronisierungsfrequenz

Konfigurieren Sie, wie oft die Automatisierung Daten hochladen soll:

Wählen Sie eine Zahl und ein Intervall.

Tests und Überprüfung

Manuelle Tests

1. Tippen Sie auf "Manueller Export" im Automatisierungskonfigurationsbildschirm
2. Wählen Sie einen Datumsbereich
3. Tippen Sie auf "Exportieren", um eine Testanfrage zu senden
4. Überprüfen Sie Ihren Endpunkt, um zu bestätigen, dass die Daten empfangen wurden

Aktivitätsprotokolle anzeigen

1. Tippen Sie auf "Aktivitätsprotokolle anzeigen" im Automatisierungskonfigurationsbildschirm
2. Überprüfen Sie die letzten Automatisierungsausführungen
3. Prüfen Sie auf Fehler oder Warnungen
4. Überprüfen Sie Anforderungszeitstempel und Antwortstatus

Datenformat überprüfen

Die App fügt automatisch diese Header in jede Anfrage ein:

• Content-Type - Basierend auf Export-Format gesetzt
• automation-name - Der Name Ihrer Automatisierung
• automation-id - Eindeutiger Bezeichner für die Automatisierung
• automation-aggregation - Die ausgewählte Zeitgruppierung
• automation-period - Der ausgewählte Datumsbereich
• session-id - Eindeutiger Bezeichner für jede Anfrage

Fehlerbehebung

Häufige Probleme

Daten nicht am Endpunkt empfangen

• Überprüfen Sie, ob die Endpunkt-URL korrekt ist
• Überprüfen Sie, ob Ihr Endpunkt POST-Anfragen akzeptiert
• Überprüfen Sie die Authentifizierungs-Header
• Überprüfen Sie die Endpunktprotokolle auf eingehende Anfragen
• Überprüfen Sie die Netzwerkverbindung

Tipps und bewährte Praktiken

1. Leistung:

   • Verwenden Sie eine angemessene Zeitgruppierung, um Detail vs. Datengröße auszugleichen
   • Wählen Sie nur die Metriken aus, die Sie benötigen

2. Zuverlässigkeit:

   • Legen Sie angemessene Timeout-Werte basierend auf der Antwortzeit Ihres Endpunkts fest
   • Überwachen Sie Aktivitätsprotokolle regelmäßig

3. Datenformat:

   • Verwenden Sie JSON für strukturierte Daten und APIs
   • Verwenden Sie CSV für einfache Datenanalyse oder Tabellenkalkulationsintegration
   • Erwägen Sie Batch-Anfragen für große Datensätze oder separate Verarbeitung