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
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=jsonoder deaktivierebatchrequests. - 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.