Αυτοματισμός Deep Link

Δημιουργήστε αυτοματισμό REST API ανοίγοντας URL σε iPhone ή iPad. Οι βαθιοί σύνδεσμοι δεν ρυθμίζουν άλλους προορισμούς.

Μορφή URL

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

Το url είναι υποχρεωτικό. Δώστε περιγραφικό name· αν παραλειφθεί, η προεπιλογή είναι Automation. Τα ονόματα παραμέτρων δεν διακρίνουν πεζά/κεφαλαία. Κωδικοποιήστε ως URL τιμές παραμέτρων που περιέχουν κενά ή δεσμευμένους χαρακτήρες.

Ανοίξτε τη URL στη συσκευή ή χρησιμοποιήστε Άνοιγμα διευθύνσεων URL στις Συντομεύσεις. Ελέγξτε τον δημιουργημένο αυτοματισμό στο Health Auto Export πριν τον ενεργοποιήσετε.

Αναφορά παραμέτρων

Οι boolean δέχονται true/false, 1/0 ή yes/no. Ορίστε το datatype πριν τις επιλογές ειδικές για δεδομένα και το format πριν το aggregatedata, ώστε μεταγενέστερες επιλογές να μην αντικαθιστούν προηγούμενες ρυθμίσεις.

Βασικές ρυθμίσεις

Παράμετρος	Τιμές ή σημασία	Προεπιλογή
url	URL τελικού σημείου προσβάσιμο από τη συσκευή	Υποχρεωτικό
name	Μη κενό όνομα αυτοματισμού	Automation
enabled	Ενεργοποίηση αυτόματων εκτελέσεων	false
datatype	Τύπος δεδομένων παρακάτω	healthMetrics
format	json, csv, markdown ή md	json
exportversion	v1, v2, 1 ή 2	v2
period	none, lastsync, today, yesterday, previous7days	none
requesttimeout	Ακέραια δευτερόλεπτα, 60–86400	60
headers	Ζεύγη κλειδιού/τιμής χωρισμένα με κόμμα	Κανένα
batchrequests	Boolean· μόνο JSON	false

Έγκυροι τύποι δεδομένων είναι healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking και medications. Η Κατάσταση νου απαιτεί iOS 18 ή νεότερο· οι εξαγωγές φαρμάκων απαιτούν iOS 26 ή νεότερο.

Για σημασίες εύρους ημερομηνιών, δείτε Εύρος ημερομηνιών. Όλοι οι βαθιοί σύνδεσμοι δημιουργούν αυτοματισμούς REST API· δεν υπάρχει παράμετρος exportDestination.

Μετρήσεις υγείας

Παράμετρος	Τιμές ή σημασία	Προεπιλογή
metrics	Ακριβή ονόματα μετρήσεων χωρισμένα με κόμμα, π.χ. Step Count,Heart Rate	Όλες οι διαθέσιμες μετρήσεις
aggregatedata	Boolean· χρησιμοποιήστε false για μεμονωμένες αναγνώσεις όπου υποστηρίζεται	true
interval	none, minutes, hours, days, weeks, months, years	none
aggregatesleep	Boolean που ελέγχει τη σύνοψη ύπνου	true

Τα metrics, aggregatedata και interval ισχύουν για μετρήσεις υγείας. Η επιλογή CSV ενεργοποιεί τη σύνοψη· για μεμονωμένες αναγνώσεις χρησιμοποιήστε JSON. Κατά τη δημιουργία συνδέσμων ορίστε ρητά την επιθυμητή σύνοψη.

Προπονήσεις

Παράμετρος	Τιμές ή σημασία	Προεπιλογή όταν datatype=workouts
includeroutes	Boolean	true
includeworkoutmetadata	Boolean	true
workoutsmetadatainterval	minutes ή seconds· Έκδοση 2	minutes
workouttypes	Αναγνωριστικά τύπου προπόνησης Apple χωρίς πρόσημο, χωρισμένα με κόμμα	Όλοι οι τύποι

Μην συμπεριλαμβάνετε επιλογές συγκέντρωσης μετρήσεων υγείας σε σύνδεσμο προπόνησης.

Ρυθμός και ειδοποιήσεις

Παράμετρος	Τιμές ή σημασία	Προεπιλογή
syncinterval	minutes, hours, days, weeks	minutes
syncquantity	Θετικός ακέραιος αριθμός διαστημάτων	5
notifyonupdate	Boolean· ειδοποίηση μετά την προετοιμασία δεδομένων	true
notifywhenrun	Boolean· ειδοποίηση μετά από επιτυχή ενέργεια προορισμού	true

Ο ρυθμός παραμένει υπό περιορισμούς παρασκηνίου και δεδομένων υγείας· δεν είναι ακριβές πρόγραμμα.

Έλεγχος ταυτότητας και κωδικοποίηση

Η τιμή headers αποτελείται από εναλλασσόμενα κλειδιά και τιμές:

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

Κάθε κλειδί απαιτεί τιμή. Τα κόμματα χωρίζουν ζεύγη, επομένως αποφύγετε τιμές κεφαλίδας που περιέχουν κόμματα σε αυτή τη μορφή συνδέσμου. Κωδικοποιήστε τα κενά ως %20, τα συν ως %2B και τα ampersand ως %26. Κωδικοποιήστε την πλήρη URL τελικού σημείου όταν έχει δικές της παραμέτρους ερωτήματος.

Παραδείγματα

Επιλεγμένες μετρήσεις, συνοψισμένες ανά ώρα

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

Προπονήσεις με διαδρομές

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

Και τα δύο παραδείγματα αφήνουν τις αυτόματες εκτελέσεις απενεργοποιημένες μέχρι να ελέγξετε και να ενεργοποιήσετε τον αυτοματισμό.

Αντιμετώπιση προβλημάτων

• Σφάλμα URL ή παραμέτρου: Ξεκινήστε με ελάχιστη URL, ελέγξτε ορθογραφία και κωδικοποίηση, μετά προσθέστε επιλογές μία προς μία.
• Μη έγκυρη μέτρηση: Χρησιμοποιήστε το ακριβές όνομα μέτρησης, συμπεριλαμβανομένων κενών και κεφαλαιοποίησης.
• Σφάλμα συγκέντρωσης: Χρησιμοποιήστε επιλογές μετρήσεων υγείας μόνο με datatype=healthMetrics.
• Σφάλμα ρυθμίσεων προπόνησης: Χρησιμοποιήστε επιλογές προπόνησης με datatype=workouts· η ομαδοποίηση δευτερολέπτων απαιτεί Έκδοση 2.
• Σφάλμα δέσμης: Ορίστε format=json ή απενεργοποιήστε το batchrequests.
• Μη έγκυρος ρυθμός/χρονικό όριο: Χρησιμοποιήστε υποστηριζόμενα διαστήματα, θετική ποσότητα και χρονικό όριο 60–86400 δευτερόλεπτα.
• Η URL είναι πολύ μεγάλη: Μειώστε τη λίστα μετρήσεων/κεφαλίδων ή ρυθμίστε τις υπόλοιπες ρυθμίσεις στην εφαρμογή.

Μετά τη δημιουργία, χρησιμοποιήστε REST API — Εξαγωγή ιστορικών ή χαμένων δεδομένων για μεταφόρτωση επιλεγμένου εύρους ή έλεγχο της ρύθμισης.

Σχετική τεκμηρίωση

• Οδηγός αυτοματισμού REST API
• Επισκόπηση αυτοματισμών