Συγχρονισμός δεδομένων Apple Health στο REST API

Στείλτε εξαγωγές υγείας σε τελικό σημείο που δέχεται αιτήματα HTTP POST.

Σημαντικό — περιορισμοί αυτοματισμών: Η συσκευή σας πρέπει να είναι ξεκλείδωτη για ανάγνωση δεδομένων υγείας και το iOS δεν εγγυάται εκτελέσεις παρασκηνίου στη συχνότητα που επιλέγετε. Ελέγξτε τους Περιορισμούς αυτοματισμών πριν βασιστείτε σε αυτόματες εξαγωγές.

Άνοιγμα του αυτοματισμού

Ανοίξτε Εξαγωγή → Αυτοματοποιημένο σε iPhone ή Αυτοματισμοί στην πλευρική γραμμή iPad. Επιλέξτε Νέος αυτοματισμός ή ανοίξτε υπάρχοντα αυτοματισμό για επεξεργασία.

Όνομα, κατάσταση και ειδοποιήσεις

Εισαγάγετε όνομα που προσδιορίζει αυτόν τον αυτοματισμό. Το Ενεργοποιημένο επιτρέπει αυτόματες εκτελέσεις· αφήστε το απενεργοποιημένο μέχρι να είστε έτοιμοι.

Επιλέξτε τυχόν ειδοποιήσεις εκτέλεσης που θέλετε:

• Το Ειδοποίηση ενημέρωσης προσωρινής αποθήκευσης αναφέρει ότι προετοιμάστηκαν δεδομένα εξαγωγής.
• Το Ειδοποίηση όταν εκτελεστεί αναφέρει επιτυχημένη μεταφόρτωση στο τελικό σας σημείο.

Επιτρέψτε ειδοποιήσεις όταν σας ζητηθεί. Αυτές οι ειδοποιήσεις αναφέρουν δραστηριότητα· δεν προγραμματίζουν εκτέλεση.

Ρύθμιση τελικού σημείου

1. Επιλέξτε REST API ως Τύπο αυτοματισμού.
2. Εισαγάγετε URL προσβάσιμο από το iPhone ή το iPad, για παράδειγμα https://api.example.com/health-data.
3. Προσθέστε τυχόν απαιτούμενο έλεγχο ταυτότητας κάτω από Κεφαλίδες HTTP. Για παράδειγμα, χρησιμοποιήστε κλειδί Authorization και τιμή Bearer YOUR_TOKEN.
4. Επιλέξτε Χρονικό όριο αιτήματος κατάλληλο για το τελικό σας σημείο.

Κάθε κεφαλίδα χρειάζεται και κλειδί και τιμή. Για διακομιστή σε άλλη συσκευή, χρησιμοποιήστε την προσβάσιμη διεύθυνση δικτύου αντί για localhost.

Ρυθμίσεις τύπου δεδομένων

Επιλέξτε έναν Τύπο δεδομένων για αυτόν τον αυτοματισμό: Μετρήσεις υγείας, Προπονήσεις, Συμπτώματα, ECG, Ειδοποιήσεις καρδιακού ρυθμού, Κατάσταση νου, Παρακολούθηση κύκλου ή Φάρμακα. Η Κατάσταση νου απαιτεί iOS 18 ή νεότερο· τα Φάρμακα απαιτούν iOS 26 ή νεότερο και ξεχωριστή πρόσβαση φαρμάκων.

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

Επιλέξτε Μετρήσεις υγείας, μετά ανοίξτε Επιλογή μετρήσεων υγείας και επιλέξτε τις μετρήσεις που χρειάζεστε.

Για περιορισμό των αναγνώσεων σε συγκεκριμένες εφαρμογές ή συσκευές, ανοίξτε Προτιμώμενες πηγές, επιλέξτε μια μέτρηση και επιλέξτε τις πηγές της. Το Όλες επιτρέπει κάθε πηγή που δεν έχει αποκλειστεί. Χρησιμοποιήστε Αποκλεισμένες πηγές για να αγνοήσετε μια πηγή σε όλες τις μετρήσεις υγείας αυτού του αυτοματισμού. Οι αποκλεισμοί έχουν προτεραιότητα· μια μη επιλεγμένη πηγή δεν χρησιμοποιείται ως υποκατάστατο όταν μια προτιμώμενη πηγή δεν έχει δεδομένα. Επιλέξτε Αποθήκευση για εφαρμογή των επιλογών πηγής ή Ακύρωση για απόρριψή τους.

Προπονήσεις

Επιλέξτε Προπονήσεις για εξαγωγή εγγραφών προπόνησης. Το Συμπερίληψη δεδομένων διαδρομής προσθέτει διαθέσιμα σημεία διαδρομής στα δεδομένα προπόνησης JSON. Δεν δημιουργεί ξεχωριστές μεταφορτώσεις GPX.

Για την Έκδοση 2, ενεργοποιήστε Συμπερίληψη μετρήσεων προπόνησης για προσθήκη αναγνώσεων όπως καρδιακός ρυθμός, ενεργή ενέργεια και βήματα. Επιλέξτε Λεπτά ή Δευτερόλεπτα για την Ομαδοποίηση χρόνου μετρήσεων προπόνησης· τα δευτερόλεπτα παράγουν περισσότερη λεπτομέρεια και μεγαλύτερες εξαγωγές. Η Έκδοση 1 περιλαμβάνει πάντα μετρήσεις προπόνησης.

Ρυθμίσεις εξαγωγής

Μορφή εξαγωγής

• Το JSON διατηρεί δομημένα δεδομένα για ενσωματώσεις και ανάλυση.
• Το CSV δημιουργεί πινακοειδή αρχεία για υπολογιστικά φύλλα.
• Το Markdown δημιουργεί αναγνώσιμες επικεφαλίδες και πίνακες για σημειώσεις και αρχεία.

Έκδοση εξαγωγής

Επιλέξτε Έκδοση 2 για την τρέχουσα δομή δεδομένων. Χρησιμοποιήστε Έκδοση 1 όταν υπάρχουσα ροή εργασίας εξαρτάται από την παλαιότερη μορφή.

Εύρος ημερομηνιών

Επιλογή	Συμπεριλαμβανόμενα δεδομένα
Προεπιλογή	Η προηγούμενη ημέρα και η σημερινή έως την ώρα εκτέλεσης
Από τον τελευταίο συγχρονισμό	Από τον προηγούμενο συγχρονισμό έως την ώρα εκτέλεσης
Σήμερα	Η σημερινή ημέρα έως την ώρα εκτέλεσης
Χθες	Η προηγούμενη πλήρης ημέρα
Προηγούμενες 7 ημέρες	Οι προηγούμενες επτά πλήρεις ημέρες

Σύνοψη δεδομένων και ομαδοποίηση χρόνου

Για JSON + Μετρήσεις υγείας, ενεργοποιήστε Σύνοψη δεδομένων για συνδυασμό αναγνώσεων σε χρονικές ομάδες ή απενεργοποιήστε για μεμονωμένες αναγνώσεις όπου είναι διαθέσιμες. Η σύνοψη εξαρτάται από τη μέτρηση — για παράδειγμα, τα βήματα αθροίζονται και οι αναγνώσεις βάρους υπολογίζονται ως μέσος όρος. Οι εξαγωγές μετρήσεων υγείας CSV χρησιμοποιούν συνοψισμένα δεδομένα.

Όταν είναι διαθέσιμη η Ομαδοποίηση χρόνου, επιλέξτε πόση λεπτομέρεια θα διατηρηθεί. Οι ωριαίες ή ημερήσιες ομάδες παράγουν λιγότερες γραμμές από τις ομάδες λεπτών ή δευτερολέπτων. Οι διαθέσιμες επιλογές εξαρτώνται από το εύρος ημερομηνιών και τη μορφή. Η ομαδοποίηση χρόνου προπονήσεων ρυθμίζεται ξεχωριστά στις Προπονήσεις.

Αιτήματα δέσμης και μεγάλα φορτία

Για REST API + JSON, ενεργοποιήστε Αιτήματα δέσμης για αποστολή δεδομένων σε πολλαπλά αιτήματα. Χρησιμοποιήστε το όταν το τελικό σημείο απορρίπτει μεγάλα σώματα ή τα μεγάλα αιτήματα λήγουν χρονικά. Η υπηρεσία λήψης πρέπει να χειρίζεται κάθε αίτημα ξεχωριστά.

Η ομαδοποίηση δεν είναι διαθέσιμη για CSV και Markdown. Μειώνει το μέγεθος μεμονωμένων αιτημάτων αλλά δεν μειώνει την ποσότητα δεδομένων υγείας που πρέπει να διαβάσει η συσκευή. Δείτε Απόδοση αν η προετοιμασία είναι αργή.

Προγραμματισμός υπενθυμίσεων

Αν θέλετε προτροπή να ξεκλειδώσετε και να ανοίξετε την εφαρμογή, ενεργοποιήστε Ενεργοποίηση υπενθυμίσεων. Επιλέξτε Ωριαία, Κάθε μέρα ή Επιλεγμένες ημέρες, μετά ορίστε το λεπτό, την ώρα και τις ημέρες όπως ισχύει. Επιτρέψτε πρόσβαση ειδοποιήσεων όταν σας ζητηθεί· αν απορριφθεί, χρησιμοποιήστε Άνοιγμα ρυθμίσεων ειδοποιήσεων.

Η υπενθύμιση δεν εκτελεί τον αυτοματισμό ούτε επιβεβαιώνει επιτυχή συγχρονισμό. Πατήστε την για άνοιγμα του αυτοματισμού ή χρησιμοποιήστε Άνοιγμα και συγχρονισμός στην ειδοποίηση για αίτημα εκτέλεσης. Ο αυτοματισμός πρέπει να είναι ενεργοποιημένος· μια υπενθύμιση μπορεί να εμφανιστεί ακόμη και μετά από επιτυχή εκτέλεση παρασκηνίου. Οι αλλαγές υπενθύμισης ισχύουν όταν αποθηκεύετε.

Συχνότητα συγχρονισμού και αποθήκευση

Στη Συχνότητα συγχρονισμού επιλέξτε αριθμό και Λεπτά, Ώρες, Ημέρες ή Εβδομάδες — για παράδειγμα κάθε 15 λεπτά. Αυτός είναι επιθυμητός ρυθμός παρασκηνίου, όχι εγγυημένο πρόγραμμα.

Η συσκευή πρέπει να είναι ξεκλείδωτη όταν διαβάζονται δεδομένα υγείας. Ενεργοποιήστε την Ανανέωση εφαρμογής στο παρασκήνιο για το Health Auto Export και απενεργοποιήστε τη Λειτουργία χαμηλής κατανάλωσης για αυτόματες εκτελέσεις. Το iOS μπορεί να καθυστερήσει εκτελέσεις όταν η συσκευή ήταν ανενεργή ή οι πόροι συστήματος είναι περιορισμένοι.

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

Κεφαλίδες αιτήματος

Η εφαρμογή ορίζει Content-Type για την επιλεγμένη μορφή και περιλαμβάνει:

Κεφαλίδα	Σημασία
automation-name	Όνομα αυτοματισμού
automation-id	Αναγνωριστικό αυτοματισμού
automation-aggregation	Επιλεγμένη ομαδοποίηση χρόνου
automation-period	Επιλεγμένο εύρος ημερομηνιών
session-id	Αναγνωριστικό αιτήματος

Εξαγωγή ιστορικών ή χαμένων δεδομένων

Χρησιμοποιήστε Χειροκίνητη μεταφόρτωση όταν ρυθμίζετε για πρώτη φορά τον αυτοματισμό για εξαγωγή ιστορικών δεδομένων ή αργότερα για κάλυψη ημερομηνιών που έχασε ο αυτόματος συγχρονισμός. Μπορείτε επίσης να τη χρησιμοποιήσετε για έλεγχο της ρύθμισης.

1. Ανοίξτε τον αυτοματισμό και επιλέξτε Χειροκίνητη μεταφόρτωση κάτω από Εξαγωγή υπαρχόντων δεδομένων.
2. Ορίστε τις ημερομηνίες Έναρξη και Λήξη, μετά επιλέξτε Έναρξη εξαγωγής.
3. Ελέγξτε το ληφθέν αίτημα, τις κεφαλίδες και το σώμα στο τελικό σημείο.

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

• Δεν ελήφθη αίτημα: Ελέγξτε τη URL, την προσβασιμότητα δικτύου και τα αρχεία καταγραφής διακομιστή.
• Σφάλμα ελέγχου ταυτότητας: Ελέγξτε το κλειδί κεφαλίδας, το token και τα δικαιώματα τελικού σημείου.
• Απόρριψη ή λήξη φορτίου: Ελέγξτε τα όρια μεγέθους διακομιστή, χρησιμοποιήστε ομαδοποίηση για JSON ή μειώστε το μέγεθος εξαγωγής.

Ανοίξτε τον αυτοματισμό και επιλέξτε Προβολή αρχείων καταγραφής δραστηριότητας για έλεγχο εκτέλεσης. Οι Προειδοποιήσεις επισημαίνουν πιθανά προβλήματα όπως αργή ανάκτηση δεδομένων· τα σφάλματα προσδιορίζουν αποτυχημένα βήματα. Για αναφορά προβλήματος, δείτε Λήψη βοήθειας.