Συγχρονισμός με REST API

Οι αυτοματισμοί REST API σάς επιτρέπουν να εξάγετε αυτόματα τα δεδομένα υγείας σας σε οποιαδήποτε υπηρεσία web δέχεται αιτήματα HTTP POST. Ιδανικό για ενσωμάτωση με προσαρμοσμένα backends, API τρίτων ή webhooks.

Επισκόπηση

Οι αυτοματισμοί REST API αποστέλλουν τα δεδομένα υγείας σας σε καθορισμένο URL με αιτήματα HTTP POST. Ο αυτοματισμός μπορεί να στείλει δεδομένα σε μορφή JSON ή CSV, με ρυθμιζόμενες κεφαλίδες για ταυτοποίηση και προσαρμοσμένα μεταδεδομένα.

Περιπτώσεις χρήσης:

• Ενσωμάτωση με προσαρμοσμένες υπηρεσίες backend
• Αποστολή δεδομένων σε webhooks
• Συγχρονισμός με API τρίτων
• Δημιουργία προσαρμοσμένων πινάκων ελέγχου ή πλατφορμών αναλυτικών

Βασικά χαρακτηριστικά:

• Υποστήριξη μορφών JSON και CSV
• Προσαρμοσμένες κεφαλίδες HTTP για ταυτοποίηση
• Ρυθμιζόμενο χρονικό όριο αιτήματος
• Χειροκίνητη εξαγωγή ιστορικών δεδομένων

Περιορισμοί

• Πρόσβαση σε δεδομένα υγείας: Οι εφαρμογές δεν επιτρέπεται να έχουν πρόσβαση σε δεδομένα υγείας όσο το iPhone είναι κλειδωμένο. Οι αυτοματισμοί εκτελούνται μόνο όταν η συσκευή σας είναι ξεκλείδωτη. Αυτό μπορεί να επηρεάσει την επικαιρότητα. Δείτε τις οδηγίες για χειροκίνητο συγχρονισμό.

• Επεξεργασία στο παρασκήνιο: Το iOS περιορίζει την επεξεργασία στο παρασκήνιο για την εξοικονόμηση μπαταρίας. Οι αυτοματισμοί βασίζονται στην Ανανέωση εφαρμογών στο παρασκήνιο και ενδέχεται να μην εκτελούνται αμέσως αν:

  • Η Ανανέωση εφαρμογών στο παρασκήνιο είναι απενεργοποιημένη για την εφαρμογή
  • Η συσκευή είναι σε λειτουργία χαμηλής κατανάλωσης ενέργειας
  • Η συσκευή έχει μείνει ανενεργή για παρατεταμένα διαστήματα
  • Οι πόροι του συστήματος είναι περιορισμένοι
  • Πολλές εφαρμογές ανταγωνίζονται για χρόνο εκτέλεσης στο παρασκήνιο

Προαπαιτούμενα

• Έγκυρο τελικό σημείο URL που δέχεται αιτήματα HTTP POST
• Διαπιστευτήρια ταυτοποίησης (αν απαιτεί το τελικό σημείο σας)
• Σύνδεση δικτύου προς το τελικό σημείο

Ρύθμιση

Μεταβείτε στην οθόνη Αυτόματες εξαγωγές από την κύρια πλοήγηση, πατήστε Νέος αυτοματισμός και επιλέξτε REST API ως τύπο αυτοματισμού.

Όνομα αυτοματισμού

Εισαγάγετε ένα περιγραφικό όνομα (π.χ. «API backend μου», «Ενσωμάτωση webhook»).

Ειδοποιήσεις

Ρυθμίστε πότε θέλετε να λαμβάνετε ειδοποιήσεις:

• Ειδοποίηση κατά την ενημέρωση κρυφής μνήμης - Όταν ενημερώνονται τα δεδομένα στην κρυφή μνήμη
• Ειδοποίηση κατά την εκτέλεση - Κάθε φορά που εκτελείται ο αυτοματισμός

Ρύθμιση URL

Εισαγάγετε το πλήρες URL όπου θέλετε να στέλνετε τα δεδομένα υγείας. Πρέπει να είναι πλήρες URL συμπεριλαμβανομένου του πρωτοκόλλου (http:// ή https://).

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

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

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

Χρονικό όριο αιτήματος

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

Κεφαλίδες HTTP

Προσθέστε προσαρμοσμένες κεφαλίδες HTTP για ταυτοποίηση ή μεταδεδομένα. Συνήθεις περιπτώσεις:

• Κλειδιά API: X-API-Key: your-api-key
• Διακριτικά εξουσιοδότησης: Authorization: Bearer your-token
• Παράκαμψη τύπου περιεχομένου: Content-Type: application/json

Για προσθήκη κεφαλίδων:

1. Πατήστε Προσθήκη κεφαλίδων
2. Εισαγάγετε το κλειδί κεφαλίδας στο αριστερό πεδίο
3. Εισαγάγετε την τιμή στο δεξί πεδίο
4. Επαναλάβετε για επιπλέον κεφαλίδες

Σημαντικό: Κάθε κλειδί κεφαλίδας πρέπει να έχει αντίστοιχη τιμή. Οι κενές κεφαλίδες αγνοούνται.

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

Τύπος δεδομένων

Επιλέξτε ποιον τύπο δεδομένων υγείας θα εξάγετε:

• Μετρήσεις υγείας - Βήματα, καρδιακός ρυθμός, ύπνος και άλλες μετρήσεις
• Προπονήσεις - Άσκηση και δραστηριότητες ευεξίας
• Συμπτώματα - Συμπτώματα και καταστάσεις υγείας
• ΗΚΓ - Καταγραφές ηλεκτροκαρδιογραφήματος
• Ειδοποιήσεις καρδιακού ρυθμού - Συμβάντα υψηλού/χαμηλού καρδιακού ρυθμού
• Κατάσταση διάθεσης - Καταχωρήσεις διάθεσης και ψυχικής κατάστασης (iOS 18.0+)
• Παρακολούθηση κύκλου - Δεδομένα κύκλου και αναπαραγωγικής υγείας
• Φάρμακα - Καταγραφές φαρμάκων και συμμόρφωση (iOS 26.0+)

Ρύθμιση μετρήσεων υγείας

Όταν επιλέγονται οι Μετρήσεις υγείας:

Επιλογή μετρήσεων υγείας - Επιλέξτε ποιες μετρήσεις θα συμπεριληφθούν.

Συμβουλή: Η επιλογή μόνο των αναγκαίων μετρήσεων βελτιώνει τον χρόνο επεξεργασίας και μειώνει το μέγεθος δεδομένων.

Προτιμώμενες πηγές - Ρυθμίστε προτεραιότητα πηγών όταν πολλές παρέχουν την ίδια μέτρηση.

Ρύθμιση προπόνησης

Όταν επιλέγονται οι Προπονήσεις:

Συμπερίληψη δεδομένων διαδρομής - Ενεργοποιήστε για διαδρομές σε προπονήσεις με τοποθεσία.

Συμπερίληψη μετρήσεων προπόνησης - Ενεργοποιήστε για μετρήσεις υγείας κατά την προπόνηση.

Ομαδοποίηση χρόνου (μετρήσεις προπόνησης) - Με Έκδοση εξαγωγής 2 και ενεργοποιημένη Συμπερίληψη μετρήσεων προπόνησης:

• Λεπτά - Ομαδοποίηση ανά λεπτό
• Δευτερόλεπτα - Ομαδοποίηση ανά δευτερόλεπτο

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

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

Επιλέξτε τη μορφή εξαγωγής:

• Μορφή JSON - Λεπτομερείς δομές με ένθετα αντικείμενα. Κατάλληλη για API, βάσεις δεδομένων και εφαρμογές που χρειάζονται δομημένα δεδομένα. Περιλαμβάνει περισσότερες λεπτομέρειες για σύνθετους τύπους όπως φάσεις ύπνου και AFib.

• Μορφή CSV - Πινακοειδή δεδομένα για εισαγωγή σε υπολογιστικά φύλλα. Κατάλληλη για απλή ανάλυση ή όταν το τελικό σημείο περιμένει CSV.

Σημείωση: Η κεφαλίδα Content-Type ορίζεται αυτόματα σε application/json για εξαγωγές JSON και multipart/form-data για CSV.

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

Επιλέξτε έκδοση εξαγωγής. Οι εκδόσεις επιτρέπουν μετάβαση με τον δικό σας ρυθμό και ελαχιστοποιούν ασυμβατότητες.

• Έκδοση 1 - Παλαιότερη μορφή· χρησιμοποιήστε την αν οι ροές εργασίας σας εξαρτώνται από αυτή
• Έκδοση 2 - Τρέχουσα μορφή με ενισχυμένα δεδομένα προπόνησης και περισσότερες επιλογές μεταδεδομένων

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

Επιλέξτε πότε θα εξάγονται τα δεδομένα:

• Προεπιλογή - Συγχρονίζει για την πλήρη προηγούμενη ημέρα συν δεδομένα μέχρι τώρα
• Από τον τελευταίο συγχρονισμό - Σε κάθε συγχρονισμό εξάγει όλα τα δεδομένα από την τελευταία εκτέλεση μέχρι τώρα
• Σήμερα - Όλα τα δεδομένα της τρέχουσας ημέρας μέχρι τώρα
• Χθες - Όλα τα δεδομένα της πλήρους προηγούμενης ημέρας
• Προηγούμενες 7 ημέρες - Δεδομένα για τις πλήρεις προηγούμενες επτά ημέρες

Σύνοψη δεδομένων

Όταν χρησιμοποιείτε JSON με τύπο Μετρήσεις υγείας, ενεργοποιήστε ή απενεργοποιήστε τη Σύνοψη δεδομένων.

• Ενεργό - Συγκεντρωτικές περιλήψεις
• Ανενεργό - Αποσυναρτημένα δεδομένα όπου είναι δυνατόν

Σημείωση: Ισχύει μόνο για JSON με Μετρήσεις υγείας. Με CSV ή πολλαπλές μετρήσεις τα δεδομένα είναι πάντα συγκεντρωμένα.

Ομαδοποίηση χρόνου

Όταν χρησιμοποιείτε JSON με ενεργή Σύνοψη δεδομένων, επιλέξτε πώς θα συγκεντρώνονται.

Σημείωση: Η μορφή CSV πάντα συγκεντρώνει δεδομένα. Η ομαδοποίηση ανά λεπτό/δευτερόλεπτο μπορεί να αυξήσει σημαντικά τον χρόνο επεξεργασίας και το μέγεθος.

Αιτήματα δέσμης

Όταν χρησιμοποιείτε JSON, ενεργοποιήστε Αιτήματα δέσμης για αποστολή σε πολλαπλά αιτήματα αντί για ένα φορτίο.

• Ενεργό - Κατανέμει δεδομένα σε πολλαπλά αιτήματα για αποφυγή υπερβολικά μεγάλων φορτίων
• Ανενεργό - Στέλνει όλα τα δεδομένα σε ένα αίτημα

Ρυθμός συγχρονισμού

Ρυθμίστε πόσο συχνά ο αυτοματισμός θα μεταφορτώνει δεδομένα:

Επιλέξτε αριθμό και διάστημα.

Δοκιμή και επαλήθευση

Χειροκίνητη δοκιμή

1. Πατήστε Χειροκίνητη εξαγωγή στην οθόνη ρύθμισης
2. Επιλέξτε εύρος ημερομηνιών
3. Πατήστε Εξαγωγή για αποστολή δοκιμαστικού αιτήματος
4. Ελέγξτε το τελικό σημείο για επιβεβαίωση λήψης

Προβολή καταγραφών δραστηριότητας

1. Πατήστε Προβολή καταγραφών δραστηριότητας
2. Ελέγξτε τις πρόσφατες εκτελέσεις
3. Αναζητήστε σφάλματα ή προειδοποιήσεις
4. Επαληθεύστε χρονοσφραγίδες αιτημάτων και κατάσταση απόκρισης

Επαλήθευση μορφής δεδομένων

Η εφαρμογή συμπεριλαμβάνει αυτόματα αυτές τις κεφαλίδες σε κάθε αίτημα:

• Content-Type - Ορίζεται βάσει μορφής εξαγωγής
• automation-name - Όνομα του αυτοματισμού σας
• automation-id - Μοναδικό αναγνωριστικό αυτοματισμού
• automation-aggregation - Η επιλεγμένη ομαδοποίηση χρόνου
• automation-period - Το επιλεγμένο εύρος ημερομηνιών
• session-id - Μοναδικό αναγνωριστικό για κάθε αίτημα

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

Συνηθισμένα ζητήματα

Δεν λαμβάνονται δεδομένα στο τελικό σημείο

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

Συμβουλές και βέλτιστες πρακτικές

1. Αυτόματος συγχρονισμός:

   • Φορτίστε τη συσκευή και χρησιμοποιήστε το Κατοπτρισμό iPhone
     • Όταν η συσκευή φορτίζει, το iOS επιβάλλει λιγότερους περιορισμούς
     • Με το Κατοπτρισμό iPhone, η συσκευή συμπεριφέρεται σαν ξεκλείδωτη και τα δεδομένα υγείας είναι προσβάσιμα από το Health Auto Export

2. Απόδοση:

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

3. Αξιοπιστία:

   • Ορίστε κατάλληλα χρονικά όρια βάσει χρόνου απόκρισης του τελικού σημείου
   • Παρακολουθείτε τακτικά τις Καταγραφές δραστηριότητας

4. Μορφή δεδομένων:

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