Apple Health Verilerini Home Assistant ile Senkronize Et

Home Assistant otomasyonları, sağlık verilerinizi Home Assistant'a sensör durumları olarak otomatik olarak senkronize etmenizi sağlar. Bu entegrasyon, sağlık verilerinizi Home Assistant otomasyonlarında, panellerinde ve diğer entegrasyonlarda kullanmanıza olanak tanır.

Genel Bakış

Home Assistant otomasyonları, sağlık metriklerinizi Home Assistant'ın REST API'sine göndererek, Home Assistant örneğinizde kullanılabilecek sensör durumları oluşturur veya günceller. Veriler, Home Assistant'ın /states/ API'si için özel olarak formatlanmıştır.

Kullanım Senaryoları:

• Home Assistant panellerinde sağlık metriklerini görüntüleme
• Sağlık verilerine dayalı otomasyonlar oluşturma
• Sağlık verilerini diğer akıllı ev cihazlarıyla entegre etme
• Home Assistant'da zaman içindeki sağlık trendlerini takip etme

Temel Özellikler:

• Otomatik sensör durumu oluşturma
• Yalnızca JSON formatı (Home Assistant için optimize edilmiş)
• Yalnızca Health Metrics veri türü
• Basit URL yapılandırması

Sınırlamalar

• Sağlık Verilerine Erişim: Uygulamalar iPhone kilitliyken sağlık verilerine erişemez. Otomasyonlar yalnızca cihazınızın kilidi açık olduğu dönemlerde çalışacaktır. Bu, veri tazeliğini etkileyebilir. Verileri güncel tutmak için manuel senkronizasyon talimatlarına bakın.

• Arka Plan İşleme: iOS, pil ömrünü korumak için arka plan işlemeyi sınırlar. Otomasyonlar Uygulama Arka Plan Yenileme'ye bağlıdır ve şu durumlarda hemen çalışmayabilir:

  • Uygulama için Arka Plan Yenileme devre dışı bırakılmışsa
  • Cihaz Düşük Güç Modu'ndaysa
  • Cihaz uzun süreler boyunca hareketsiz kaldıysa
  • Sistem kaynakları kısıtlıysa
  • Birden fazla uygulama arka plan yürütme süresi için rekabet ediyorsa

• Yalnızca Health Metrics veri türünü destekler

• Yalnızca JSON formatı (değiştirilemez)

Önkoşullar

• Ağınızda çalışan ve erişilebilir bir Home Assistant örneği
• Home Assistant API erişim tokeni (Uzun Ömürlü Erişim Tokeni)
• Home Assistant örneğinize ağ bağlantısı
• REST API'yi destekleyen Home Assistant sürümü

Yapılandırma

Ana navigasyondan Otomatik Dışa Aktarmalar ekranına gidin, ardından "Yeni Otomasyon"a dokunun ve Otomasyon Türü olarak "Home Assistant"ı seçin.

Otomasyon Adı

Otomasyonunuz için açıklayıcı bir ad girin. Bu ad, Home Assistant'ta sensör varlık kimliğini oluşturmak için kullanılacaktır.

Not: Otomasyon adı, varlık kimliğini oluşturmak için küçük harfe dönüştürülür ve boşluklar kaldırılır. Örneğin, "Sağlık Verilerim" hae.saglikverilerim olur.

Bildirimler

Bildirimleri ne zaman almak istediğinizi yapılandırın:

• Önbellek Güncellemesinde Bildir - Önbelleğe alınan veriler güncellendiğinde bildirim alın
• Çalıştığında Bildir - Otomasyon her çalıştığında bildirim alın

Home Assistant URL'si

Home Assistant örneğinizin temel URL'sini girin. Varsayılanı kullanmıyorsanız bu, protokolü ve portu içermelidir.

Örnek URL'ler:

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

Not: URL, cihazınızdan erişilebilir olmalıdır. HTTPS kullanıyorsanız, sertifikanızın geçerli olduğundan emin olun veya bir istisna ekleyin.

Otomatik Oluşturulan Uç Nokta

Uygulama, otomasyon adınıza göre tam API uç noktasını otomatik olarak oluşturur:

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

Örneğin, URL'niz http://homeassistant.local:8123 ve otomasyon adınız "Sağlık Metrikleri" ise, uç nokta şu olacaktır:

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

Bu uç nokta, referans için URL alanının altında gösterilir.

İstek Zaman Aşımı

Home Assistant'a HTTP istekleri için bir zaman aşımı aralığı seçin.

Mevcut zaman aşımı seçenekleri:

• 60 saniye - Varsayılan, çoğu Home Assistant örneği için uygun
• 300 saniye (5 dakika) - Daha yavaş Home Assistant örnekleri için
• 1800 saniye (30 dakika) - Çok yavaş işleme için
• 3600 saniye (1 saat) - Maksimum önerilen zaman aşımı

HTTP Başlıkları

Home Assistant API erişimi için kimlik doğrulama başlıkları ekleyin. Uzun Ömürlü Erişim Tokeninizle bir Authorization başlığı eklemeniz gerekecektir.

Gerekli Başlık:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Uzun Ömürlü Erişim Tokeni almak için:

1. Home Assistant'ı açın
2. Profilinize gidin (sol alttaki adınıza tıklayın)
3. "Uzun Ömürlü Erişim Tokenleri"ne kaydırın
4. "Token Oluştur"a tıklayın
5. Bir ad verin (ör. "Health Auto Export")
6. Tokeni kopyalayın ve başlık değeri alanına yapıştırın

İsteğe Bağlı Başlıklar:
Home Assistant kurulumunuz için gerekirse ek başlıklar ekleyebilirsiniz.

Başlık eklemek için:

1. "Başlık Ekle"ye dokunun
2. Başlık anahtarını sol alana girin
3. Başlık değerini sağ alana girin
4. Ek başlıklar için tekrarlayın

Önemli: Her başlık anahtarının karşılık gelen bir değeri olmalıdır. Boş başlıklar yok sayılır.

Veri Türü Ayarları

Veri Türü

Not: Home Assistant otomasyonları yalnızca Health Metrics veri türünü destekler. Bu ayar değiştirilemez ve otomatik olarak Health Metrics'e ayarlanır.

Health Metrics Yapılandırması

Health Metrics Seç - Hangi belirli metriklerin dahil edileceğini seçin. Tüm mevcut metrikleri seçebilir veya belirli olanları seçebilirsiniz.

İpucu: Yalnızca ihtiyacınız olan metrikleri seçmek, işleme süresini iyileştirebilir ve Home Assistant'a gönderilen veri boyutunu azaltabilir.

Tercih Edilen Kaynaklar - Aynı metriği sağlayan birden fazla kaynak olduğunda hangi veri kaynaklarının öncelikli olduğunu yapılandırın.

Dışa Aktarma Ayarları

Dışa Aktarma Formatı

Not: Home Assistant otomasyonları yalnızca JSON formatını destekler. Bu ayar değiştirilemez ve otomatik olarak JSON'a ayarlanır.

Dışa Aktarma Sürümü

Not: Dışa Aktarma Sürümü, format Home Assistant'ın durum API'si için özel olarak optimize edildiğinden Home Assistant otomasyonları için kullanılamaz.

Tarih Aralığı

Verilerin ne zaman dışa aktarılacağını seçin:

• Varsayılan - Önceki günün tamamı için verileri artı mevcut tarih ve saate kadar verileri senkronize eder
• Bugün - Mevcut tarih için mevcut saate kadar tüm verileri senkronize eder
• Dün - Önceki günün tamamı için tüm verileri senkronize eder

Not: Home Assistant otomasyonları "Gerçek Zamanlı", "Son Senkronizasyondan Beri" veya "Önceki 7 Gün" seçeneklerini desteklemez.

Verileri Özetle

Health Metrics için Verileri Özetle'yi AÇ veya KAPAT.

• AÇIK - Toplanmış veri özetleri sağlar (varsayılan)
• KAPALI - Mümkün olduğunda ayrıştırılmış veriler sağlar

Not: Bu ayar yalnızca Health Metrics veri türü için geçerlidir.

Zaman Gruplandırma

Verileri Özetle etkinleştirildiğinde, verilerin nasıl toplanacağını seçin:

• Varsayılan - Toplama yok, ham veri noktaları
• Günler - Verileri güne göre gruplar (önerilir)

Senkronizasyon Sıklığı

Otomasyonun Home Assistant ile verileri ne sıklıkla senkronize edeceğini yapılandırın:

Bir sayı ve aralık seçin.

Test ve Doğrulama

Manuel Test

1. Otomasyon yapılandırma ekranında "Manuel Dışa Aktarma"ya dokunun
2. Bir tarih aralığı seçin
3. Test isteği göndermek için "Dışa Aktar"a dokunun
4. Sensör durumunun oluşturulduğunu/güncellendiğini doğrulamak için Home Assistant'ı kontrol edin

Home Assistant'ta Doğrulama

1. Home Assistant'ı açın
2. Geliştirici Araçları > Durumlar'a gidin
3. hae.{your_automation_name} (küçük harf, boşluk yok) arayın
4. Sensör durumunun sağlık verilerinizi gösterdiğini doğrulayın
5. Son senkronizasyonları onaylamak için "Son Güncelleme" zaman damgasını kontrol edin

Etkinlik Günlüklerini Görüntüleme

1. Otomasyon yapılandırma ekranında "Etkinlik Günlüklerini Görüntüle"ye dokunun
2. Son otomasyon çalıştırmalarını gözden geçirin
3. Hataları veya uyarıları kontrol edin
4. İstek zaman damgalarını ve yanıt durumunu doğrulayın

Home Assistant Günlüklerini Kontrol Etme

Veriler Home Assistant'ta görünmüyorsa:

1. Home Assistant'ı açın
2. Ayarlar > Sistem > Günlükler'e gidin
3. REST API veya sensör durumlarıyla ilgili hataları arayın
4. Kimlik doğrulama hatalarını veya geçersiz veri formatını kontrol edin

Sorun Giderme

Yaygın Sorunlar

Kimlik Doğrulama Hataları

• Uzun Ömürlü Erişim Tokeninizin doğru olduğunu doğrulayın
• Authorization başlığının şu şekilde formatlandığından emin olun: Bearer YOUR_TOKEN
• Tokenin süresinin dolmadığını veya iptal edilmediğini kontrol edin
• Tokenin Home Assistant'ta uygun izinlere sahip olduğunu doğrulayın

Sensör Home Assistant'ta Görünmüyor

• Otomasyon adının özel karakterler içermediğini kontrol edin
• Varlık kimliği formatını doğrulayın: hae.{automation_name} (küçük harf, boşluk yok)
• Home Assistant günlüklerinde hataları kontrol edin
• API isteğinin başarılı olduğundan emin olun (Etkinlik Günlüklerini kontrol edin)

Veriler Güncellenmiyor

• Otomasyonun etkin olduğunu kontrol edin
• Hatalar için Etkinlik Günlüklerini gözden geçirin
• Home Assistant'a ağ bağlantısının olduğundan emin olun

Bağlantı Zaman Aşımı

• Home Assistant'ın çalıştığını ve erişilebilir olduğunu doğrulayın
• Ağ bağlantısını kontrol edin
• Home Assistant yavaş yanıt veriyorsa İstek Zaman Aşımı ayarını artırın
• URL ve portun doğru olduğunu doğrulayın

Hata Mesajları

Uygulama şu durumlarda hata mesajları gösterecektir:

• URL geçersiz veya erişilemez
• Kimlik doğrulama başarısız olursa (Authorization başlığını kontrol edin)
• Home Assistant bir hata durum kodu döndürürse
• Ağ bağlantısı mevcut değilse

HTTP durum kodları ve Home Assistant'tan gelen hata mesajları dahil olmak üzere ayrıntılı hata bilgileri için Etkinlik Günlüklerini kontrol edin.

Home Assistant Entegrasyon İpuçları

Otomasyonlarda Sağlık Verilerini Kullanma

Sağlık verileriniz Home Assistant ile senkronize edildikten sonra, bunları otomasyonlarda kullanabilirsiniz:

automation:
  - alias: "İyi Uyku Kalitesi"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Dün gece harika uyku!"

Paneller Oluşturma

Home Assistant panonuza sağlık metrikleri ekleyin:

1. Panonuza gidin
2. Yeni bir kart ekleyin
3. "Varlıklar" veya "Gauge" kart türünü seçin
4. hae.{your_automation_name} sensör varlıklarını ekleyin

Sensör Durum Yapısı

Home Assistant'taki sensör durumu şunları içerir:

• state: Mevcut değer veya durum
• attributes: Ek veriler dahil:
  • Zaman damgası bilgileri
  • Dışa aktarılan JSON formatıyla eşleşen veri yapısı
  • Uygulanabilir olduğunda birim bilgileri

İpuçları ve En İyi Uygulamalar

1. İsimlendirme:

   • Sorunlara neden olabilecek özel karakterlerden kaçının

2. Veri Seçimi:

   • Yalnızca ihtiyacınız olan metrikleri seçin