HealthyApps Help Center

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

Ενσωματώστε τα δεδομένα υγείας σας με το Home Assistant.

Last updated: March 31, 2026

Σε αυτή τη σελίδα

Οι αυτοματοποιήσεις Home Assistant σάς επιτρέπουν να συγχρονίζετε αυτόματα τα δεδομένα υγείας σας στο Home Assistant ως καταστάσεις αισθητήρων (sensor states). Η ενσωμάτωση επιτρέπει να χρησιμοποιείτε τα δεδομένα υγείας σε αυτοματοποιήσεις, πίνακες ελέγχου και άλλες ενσωματώσεις του Home Assistant.

Επισκόπηση

Οι αυτοματοποιήσεις Home Assistant στέλνουν τις μετρικές υγείας σας στο REST API του Home Assistant, δημιουργώντας ή ενημερώνοντας καταστάσεις αισθητήρων που χρησιμοποιούνται σε ολόκληρη την εγκατάστασή σας. Τα δεδομένα διαμορφώνονται ειδικά για το API /states/<entity_id> του Home Assistant.

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

  • Εμφάνιση μετρικών υγείας σε πίνακες ελέγχου Home Assistant
  • Δημιουργία αυτοματοποιήσεων βάσει δεδομένων υγείας
  • Ενσωμάτωση δεδομένων υγείας με άλλες έξυπνες συσκευές
  • Παρακολούθηση τάσεων υγείας στο χρόνο

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

  • Αυτόματη δημιουργία κατάστασης αισθητήρα
  • Μόνο μορφή JSON (βελτιστοποιημένη για Home Assistant)
  • Μόνο τύπος δεδομένων Μετρικές υγείας
  • Απλή ρύθμιση URL

Περιορισμοί

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

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

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

  • Υποστηρίζεται μόνο ο τύπος Μετρικές υγείας

  • Μόνο μορφή JSON (δεν αλλάζει)

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

  • Εγκατάσταση Home Assistant σε λειτουργία και προσβάσιμη στο δίκτυό σας
  • Διακριτικό πρόσβασης API του Home Assistant (Long-Lived Access Token)
  • Δικτυακή συνδεσιμότητα με την εγκατάσταση Home Assistant
  • Έκδοση Home Assistant που υποστηρίζει REST API

Ρύθμιση

Μεταβείτε στην οθόνη Αυτοματοποιημένων εξαγωγών, πατήστε «Νέα αυτοματοποίηση» και επιλέξτε «Home Assistant» ως τύπο αυτοματοποίησης.

Όνομα αυτοματοποίησης

Εισαγάγετε ένα περιγραφικό όνομα. Θα χρησιμοποιηθεί για τη δημιουργία του αναγνωριστικού οντότητας (entity ID) αισθητήρα στο Home Assistant.

Σημείωση: Το όνομα μετατρέπεται σε πεζά χωρίς κενά για το entity ID. Για παράδειγμα, το «My Health Data» γίνεται hae.myhealthdata.

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

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

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

URL Home Assistant

Εισαγάγετε το βασικό URL της εγκατάστασης Home Assistant. Συμπεριλάβετε το πρωτόκολλο και τη θύρα αν δεν χρησιμοποιούνται οι προεπιλογές.

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

  • http://homeassistant.local:8123
  • http://192.168.1.100:8123

Σημείωση: Το URL πρέπει να είναι προσβάσιμο από τη συσκευή σας. Αν χρησιμοποιείτε HTTPS, βεβαιωθείτε ότι το πιστοποιητικό είναι έγκυρο ή προσθέστε εξαίρεση.

Αυτόματα δημιουργούμενο endpoint

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

{your_url}/api/states/hae.{automation_name}

Για παράδειγμα, αν το URL είναι http://homeassistant.local:8123 και το όνομα «Health Metrics», το endpoint θα είναι:

http://homeassistant.local:8123/api/states/hae.healthmetrics

Το endpoint εμφανίζεται κάτω από το πεδίο URL για αναφορά.

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

Επιλέξτε χρονικό όριο για τα αιτήματα HTTP προς το Home Assistant.

Διαθέσιμες επιλογές:

  • 60 δευτερόλεπτα — Προεπιλογή, κατάλληλη για τις περισσότερες εγκαταστάσεις
  • 300 δευτερόλεπτα (5 λεπτά) — Για πιο αργές εγκαταστάσεις
  • 1800 δευτερόλεπτα (30 λεπτά) — Για πολύ αργή επεξεργασία
  • 3600 δευτερόλεπτα (1 ώρα) — Μέγιστο συνιστώμενο όριο

Κεφαλίδες HTTP

Προσθέστε κεφαλίδες πιστοποίησης για πρόσβαση στο API. Χρειάζεστε κεφαλίδα Authorization με το Long-Lived Access Token.

Απαιτούμενη κεφαλίδα:

  • Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Για να λάβετε Long-Lived Access Token:

  1. Ανοίξτε το Home Assistant
  2. Μεταβείτε στο προφίλ σας (πατήστε το όνομά σας κάτω αριστερά)
  3. Κάντε κύλιση στο «Long-Lived Access Tokens»
  4. Πατήστε «Create Token»
  5. Δώστε ένα όνομα (π.χ. «Health Auto Export»)
  6. Αντιγράψτε το token και επικολλήστε το στο πεδίο τιμής κεφαλίδας

Προαιρετικές κεφαλίδες:

Μπορείτε να προσθέσετε επιπλέον κεφαλίδες αν χρειάζεται η ρύθμισή σας.

Για προσθήκη:

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

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

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

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

Σημείωση: Οι αυτοματοποιήσεις Home Assistant υποστηρίζουν μόνο Μετρικές υγείας. Η ρύθμιση δεν αλλάζει και ορίζεται αυτόματα σε Μετρικές υγείας.

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

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

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

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

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

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

Σημείωση: Υποστηρίζεται μόνο JSON. Η ρύθμιση δεν αλλάζει.

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

Σημείωση: Η έκδοση εξαγωγής δεν ισχύει για αυτοματοποιήσεις Home Assistant — η μορφή είναι βελτιστοποιημένη για το state API του Home Assistant.

Χρονικό εύρος

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

  • Προεπιλογή — Συγχρονίζει πλήρη προηγούμενη ημέρα και δεδομένα μέχρι την τρέχουσα ημερομηνία και ώρα
  • Σήμερα — Όλα τα δεδομένα της τρέχουσας ημέρας μέχρι τώρα
  • Χθες — Όλα τα δεδομένα της πλήρους προηγούμενης ημέρας

Σημείωση: Δεν υποστηρίζονται οι επιλογές «Real Time», «Since Last Sync» ή «Previous 7 Days».

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

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

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

Σημείωση: Ισχύει μόνο για Μετρικές υγείας.

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

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

  • Προεπιλογή — Χωρίς συγκέντρωση, ακατέργαστα σημεία
  • Ημέρες — Ομαδοποίηση ανά ημέρα (συνιστάται)

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

Ρυθμίστε πόσο συχνά συγχρονίζονται δεδομένα στο Home Assistant:

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

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

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

  1. Πατήστε «Χειροκίνητη εξαγωγή» στην οθόνη ρύθμισης
  2. Επιλέξτε χρονικό εύρος
  3. Πατήστε «Εξαγωγή» για δοκιμαστικό αίτημα
  4. Ελέγξτε το Home Assistant ότι δημιουργήθηκε/ενημερώθηκε η κατάσταση αισθητήρα

Επαλήθευση στο Home Assistant

  1. Ανοίξτε το Home Assistant
  2. Μεταβείτε σε Developer Tools > States
  3. Αναζητήστε hae.{your_automation_name} (πεζά, χωρίς κενά)
  4. Επαληθεύστε ότι η κατάσταση εμφανίζει τα δεδομένα υγείας
  5. Ελέγξτε τη χρονική σήμανση «Last Updated» για πρόσφατους συγχρονισμούς

Προβολή αρχείων δραστηριότητας

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

Έλεγχος αρχείων καταγραφής Home Assistant

Αν δεν εμφανίζονται δεδομένα:

  1. Ανοίξτε το Home Assistant
  2. Μεταβείτε σε Settings > System > Logs
  3. Αναζητήστε σφάλματα σχετικά με REST API ή καταστάσεις αισθητήρων
  4. Ελέγξτε σφάλματα πιστοποίησης ή μη έγκυρη μορφή δεδομένων

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

Συνήθη ζητήματα

Σφάλματα πιστοποίησης

  • Επαληθεύστε ότι το Long-Lived Access Token είναι σωστό
  • Η κεφαλίδα Authorization πρέπει να είναι της μορφής: Bearer YOUR_TOKEN
  • Ελέγξτε ότι το token δεν έχει λήξει ή ανακληθεί
  • Επαληθεύστε ότι το token έχει τα κατάλληλα δικαιώματα

Ο αισθητήρας δεν εμφανίζεται

  • Το όνομα αυτοματοποίησης δεν πρέπει να περιέχει ειδικούς χαρακτήρες
  • Μορφή entity ID: hae.{automation_name} (πεζά, χωρίς κενά)
  • Ελέγξτε τα αρχεία καταγραφής του Home Assistant
  • Βεβαιωθείτε ότι το αίτημα API ήταν επιτυχές (αρχεία δραστηριότητας)

Τα δεδομένα δεν ενημερώνονται

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

Λήξη χρονικού ορίου σύνδεσης

  • Το Home Assistant πρέπει να τρέχει και να είναι προσβάσιμο
  • Ελέγξτε το δίκτυο
  • Αυξήστε το Χρονικό όριο αιτήματος αν το Home Assistant αργεί να απαντήσει
  • Επαληθεύστε URL και θύρα

Μηνύματα σφάλματος

Η εφαρμογή εμφανίζει σφάλματα αν:

  • Το URL είναι άκυρο ή μη προσβάσιμο
  • Αποτυγχάνει η πιστοποίηση (κεφαλίδα Authorization)
  • Το Home Assistant επιστρέφει κωδικό σφάλματος
  • Δεν υπάρχει δικτυακή σύνδεση

Ελέγξτε τα αρχεία δραστηριότητας για λεπτομέρειες, κωδικούς κατάστασης HTTP και μηνύματα από το Home Assistant.

Συμβουλές ενσωμάτωσης Home Assistant

Χρήση δεδομένων υγείας σε αυτοματοποιήσεις

Μετά τον συγχρονισμό, μπορείτε να τα χρησιμοποιήσετε σε αυτοματοποιήσεις:

automation:
  - alias: "Good Sleep Quality"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Great sleep last night!"

Δημιουργία πινάκων ελέγχου

Προσθέστε μετρικές υγείας στον πίνακα:

  1. Μεταβείτε στον πίνακά σας
  2. Προσθέστε νέα κάρτα
  3. Επιλέξτε τύπο «Entities» ή «Gauge»
  4. Προσθέστε τις οντότητες αισθητήρα hae.{your_automation_name}

Δομή κατάστασης αισθητήρα

Η κατάσταση περιέχει:

  • state: Τρέχουσα τιμή ή κατάσταση
  • attributes: Επιπλέον δεδομένα, μεταξύ άλλων:
    • Πληροφορίες χρονικής σήμανσης
    • Δομή που ταιριάζει με το εξαγόμενο JSON
    • Μονάδες όπου εφαρμόζεται

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

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

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

  2. Ονοματολογία:

    • Αποφύγετε ειδικούς χαρακτήρες που μπορεί να προκαλέσουν προβλήματα

  3. Επιλογή δεδομένων:

    • Επιλέξτε μόνο τις μετρήσεις που χρειάζεστε