Hilfezentrum HealthyApps
Deutsch
Hilfezentrum
Hauptwebsite ↗

Hilfethemen suchen

Deep-Link-Automation

Erstelle eine REST-API-Automation, indem du eine URL auf deinem iPhone oder iPad öffnest.

Zuletzt aktualisiert: 31. Oktober 2026

Auf dieser Seite
URL-Format
Parameterreferenz Parameterreferenz GrundeinstellungenGesundheitsmetrikenWorkoutsKadenz und Benachrichtigungen
Authentifizierung und Kodierung
Beispiele Beispiele Ausgewählte Metriken, stündlich zusammengefasstWorkouts mit Routen
FehlerbehebungVerwandte Dokumentation

Erstelle eine REST-API-Automation, indem du eine URL auf deinem iPhone oder iPad öffnest. Deep Links konfigurieren keine anderen Ziele.

URL-Format

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export

url ist erforderlich. Gib einen beschreibenden name an; wenn weggelassen, ist der Standardwert Automation. Parameternamen unterscheiden nicht zwischen Groß- und Kleinschreibung. URL-kodiere Parameterwerte, die Leerzeichen oder reservierte Zeichen enthalten.

Öffne die URL auf deinem Gerät oder verwende URLs öffnen in Kurzbefehlen. Prüfe die erstellte Automation in Health Auto Export, bevor du sie aktivierst.

Parameterreferenz

Booleans akzeptieren true/false, 1/0 oder yes/no. Setze datatype vor seinen datenspezifischen Optionen und format vor aggregatedata, damit spätere Auswahlen frühere Einstellungen nicht ersetzen.

Grundeinstellungen

Parameter Werte oder Bedeutung Standard
url Endpoint-URL, erreichbar von deinem Gerät Erforderlich
name Nicht leerer Automationsname Automation
enabled Automatische Ausführungen aktivieren false
datatype Unten aufgeführter Datentyp healthMetrics
format json, csv, markdown oder md json
exportversion v1, v2, 1 oder 2 v2
period none, lastsync, today, yesterday, previous7days none
requesttimeout Ganze Sekunden, 60–86400 60
headers Durch Kommas getrennte Schlüssel/Wert-Paare Keine
batchrequests Boolean; nur JSON false

Gültige Datentypen sind healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking und medications. Gemütszustand erfordert iOS 18 oder neuer; Medikamentenexporte erfordern iOS 26 oder neuer.

Zur Bedeutung der Datumsbereiche siehe Datumsbereich. Alle Deep Links erstellen REST-API-Automationen; es gibt keinen Parameter exportDestination.

Gesundheitsmetriken

Parameter Werte oder Bedeutung Standard
metrics Exakte Metriknamen, durch Kommas getrennt, z. B. Step Count,Heart Rate Alle verfügbaren Metriken
aggregatedata Boolean; verwende false für einzelne Messwerte, wenn unterstützt true
interval none, minutes, hours, days, weeks, months, years none
aggregatesleep Boolean, steuert die Schlafzusammenfassung true

metrics, aggregatedata und interval gelten für Gesundheitsmetriken. CSV-Auswahl aktiviert die Zusammenfassung; verwende JSON für einzelne Messwerte. Gib die gewünschte Zusammenfassung beim Generieren von Links explizit an.

Workouts

Parameter Werte oder Bedeutung Standard bei datatype=workouts
includeroutes Boolean true
includeworkoutmetadata Boolean true
workoutsmetadatainterval minutes oder seconds; Version 2 minutes
workouttypes Apples vorzeichenlose Workout-Typ-Kennungen, durch Kommas getrennt Alle Typen

Füge keine Aggregationsoptionen für Gesundheitsmetriken in einen Workout-Link ein.

Kadenz und Benachrichtigungen

Parameter Werte oder Bedeutung Standard
syncinterval minutes, hours, days, weeks minutes
syncquantity Positive ganze Zahl von Intervallen 5
notifyonupdate Boolean; nach Datenvorbereitung benachrichtigen true
notifywhenrun Boolean; nach erfolgreicher Zielaktion benachrichtigen true

Die Kadenz unterliegt weiterhin den Hintergrund- und Gesundheitsdatenlimits; sie ist kein exakter Zeitplan.

Authentifizierung und Kodierung

Der Wert von headers besteht aus abwechselnden Schlüsseln und Werten:

headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY

Jeder Schlüssel erfordert einen Wert. Kommas trennen die Paare, daher vermeide Header-Werte mit Kommas in diesem Linkformat. Kodiere Leerzeichen als %20, Pluszeichen als %2B und Ampersands als %26. Kodiere die vollständige Endpoint-URL, wenn sie eigene Abfrageparameter hat.

Beispiele

Ausgewählte Metriken, stündlich zusammengefasst

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fmetrics&name=Steps%20and%20Heart%20Rate&datatype=healthMetrics&format=json&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours

Workouts mit Routen

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fworkouts&name=Workout%20Export&datatype=workouts&format=json&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes

Beide Beispiele lassen automatische Ausführungen deaktiviert, bis du die Automation prüfst und aktivierst.

Fehlerbehebung

  • URL- oder Parameterfehler: Beginne mit der minimalen URL, prüfe Schreibweise und Kodierung und füge dann Optionen einzeln hinzu.
  • Ungültige Metrik: Verwende den exakten Metriknamen einschließlich Leerzeichen und Großschreibung.
  • Aggregationsfehler: Verwende Gesundheitsmetrik-Optionen nur mit datatype=healthMetrics.
  • Fehler bei Workout-Einstellungen: Verwende Workout-Optionen mit datatype=workouts; Sekundengruppierung erfordert Version 2.
  • Batch-Fehler: Setze format=json oder deaktiviere batchrequests.
  • Ungültige Kadenz/Timeout: Verwende unterstützte Intervalle, eine positive Menge und ein Timeout von 60 bis 86400 Sekunden.
  • URL zu lang: Verringere die Metrik-/Header-Liste oder konfiguriere den Rest in der App.

Nach der Erstellung verwende REST-API — Historische oder verpasste Daten exportieren, um einen ausgewählten Bereich hochzuladen oder die Konfiguration zu prüfen.

Verwandte Dokumentation