Apple Health Verisini Home Assistant’a Senkronize Etme
Sağlık verinizi Home Assistant ile entegre edin.
Son güncelleme: 31 Ekim 2026
Bu sayfada
Sağlık metriklerini Home Assistant’a ayrı varlık durumları olarak yayınlayın. Bu hedef yalnızca sağlık metriklerini destekler.
Önemli — otomasyon sınırlamaları: Sağlık verisini okumak için cihazınızın kilidi açık olmalıdır ve iOS seçtiğiniz sıklıkta arka plan çalıştırmalarını garanti etmez. Otomatik dışa aktarmalara güvenmeden önce Otomasyon Sınırlamaları’nı inceleyin.
Otomasyonu açma
iPhone’da Dışa Aktar → Otomatik’i veya iPad kenar çubuğunda Otomasyonlar’ı açın. Yeni Otomasyon’u seçin veya düzenlemek için mevcut bir otomasyonu açın.
Ad, durum ve bildirimler
Bu otomasyonu tanımlayan bir ad girin. Etkin otomatik çalıştırmalara izin verir; hazır olana kadar kapalı bırakın.
İstediğiniz çalıştırma bildirimlerini seçin:
- Önbellek Güncellemesinde Bildir dışa aktarma verisinin hazırlandığını bildirir.
- Çalıştığında Bildir Home Assistant’a başarılı bir yayını bildirir.
İstendiğinde bildirimlere izin verin. Bu bildirimler etkinliği bildirir; bir çalıştırmayı zamanlamaz.
Home Assistant’ı bağlama
- Otomasyon Türü olarak Home Assistant’ı seçin.
- Home Assistant örneğinizin temel URL’sini girin, örneğin
http://homeassistant.local:8123. - Home Assistant profilinizde Uzun Ömürlü Erişim Belirteci oluşturun.
- HTTP Üst Bilgileri altında
Authorizationanahtarını veBearer YOUR_LONG_LIVED_ACCESS_TOKENdeğerini ekleyin.
Home Assistant örneğiniz iPhone veya iPad’den erişilebilir olmalıdır. HTTPS için cihazınızın güvendiği bir sertifika kullanın.
Sağlık Metriği Ayarları
Sağlık Metriklerini Seç’i açın ve yayınlanacak okumaları seçin.
Her metrik için kaynakları seçmek üzere Tercih Edilen Kaynaklar’ı açın. Hariç tutulmayan tüm kaynaklar için Tümü’nü kullanın veya bu otomasyonda bir kaynağı yok saymak için Hariç Tutulan Kaynaklar’ı kullanın. Hariç tutmalar önceliklidir ve seçilmemiş kaynaklar verisi olmayan tercih edilen bir kaynağın yerine geçmez. Seçimleri uygulamak için Kaydet’i, iptal etmek için İptal’i seçin.
Dışa Aktarma Ayarları
Home Assistant kendi JSON varlık durumu biçimini kullanır; dosya biçimi veya dışa aktarma sürümü seçimi yoktur.
Tarih Aralığı
- Varsayılan: Önceki günü ve çalıştırma zamanına kadar bugünü içerir.
- Bugün: Çalıştırma zamanına kadar bugünü içerir.
- Dün: Önceki tam günü içerir.
Zaman Gruplaması
Okumaları gruplanmamış tutmak için Varsayılan’ı veya günlük özetler için Günler’i seçin. Home Assistant’ta Verileri Özetle anahtarı yoktur.
Hatırlatıcıları Planla
Kilidi açıp uygulamayı açmanız için bir istem istiyorsanız Hatırlatıcıları Etkinleştir’i açın. Saatlik, Her Gün veya Seçilen Günler’i seçin, ardından geçerli olan dakika, saat ve günleri ayarlayın. İstendiğinde bildirim erişimine izin verin; erişim reddedilirse Bildirim Ayarlarını Aç’ı kullanın.
Bir hatırlatıcı otomasyonu çalıştırmaz veya başarılı bir senkronizasyonu doğrulamaz. Otomasyonu açmak için ona dokunun veya bir çalıştırma istemek için bildirimde Aç ve Senkronize Et’i kullanın. Otomasyon etkin olmalıdır; başarılı bir arka plan çalıştırmasından sonra da bir hatırlatıcı görünebilir. Hatırlatıcı değişiklikleri kaydettiğinizde uygulanır.
Senkronizasyon Sıklığı ve kaydetme
Senkronizasyon Sıklığı altında bir sayı ve Dakikalar veya Saatler seçin. Bu istenen bir arka plan ritmidir, garantili bir zamanlama değildir.
Sağlık verisi okunurken cihazınızın kilidi açık olmalıdır. Otomatik çalıştırmalar için Health Auto Export’ta Arka Planda Uygulama Yenileme’yi etkinleştirin ve Düşük Güç Modu’nu kapatın. Cihaz etkin değilse veya sistem kaynakları sınırlıysa iOS çalıştırmaları yine de geciktirebilir.
Otomatik çalıştırmalara hazır olduğunuzda Etkin’i açın, ardından otomasyonu kaydetmek için Güncelle’yi seçin. Aşağıdaki adımlarla seçili bir tarih aralığını hemen yükleyebilirsiniz.
Yayınlanan varlıklar
Seçilen her metrik bir veya daha fazla varlık üretebilir. Tanımlayıcı hae. ile başlar, ardından boşluksuz küçük harfli otomasyon adı, sonra metrik ve varsa bileşen adı gelir.
Örneğin, Health Metrics adlı bir otomasyon adımları şuraya yayınlayabilir:
http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count
Durum, seçilen gün için en son okumadır; ölçüm birimi öznitelikleriyle birlikte. Kan basıncı ve kalp atış hızı gibi metrikler ayrı bileşen varlıkları kullanır.
Bir günde veri yoksa adımlar ve ayakta durma saatleri gibi toplamlar 0 yayınlar. Kilo veya kalp atış hızı gibi diğer okumalar veri kullanılabilir olana kadar güncellenmez; bu nedenle Home Assistant aldığı son değeri göstermeye devam edebilir. Günün erken saatlerinde Watch verisi iPhone’unuza ulaşana kadar toplamlar 0 kalabilir.
Geçmiş veya kaçırılan veriyi dışa aktarma
Otomasyonu ilk kurduğunuzda geçmiş veriyi dışa aktarmak veya daha sonra otomatik senkronizasyonun kaçırdığı tarihleri kapsamak için Manuel Yükleme’yi kullanın. Kurulumunuzu kontrol etmek için de kullanabilirsiniz.
- Otomasyonu açın ve Mevcut Veriyi Dışa Aktar altında Manuel Yükleme’yi seçin.
- Başlangıç ve Bitiş tarihlerini ayarlayın, ardından Dışa Aktarmayı Başlat’ı seçin.
- Home Assistant’ta Geliştirici Araçları → Durumlar’ı açın ve otomasyonunuzun
hae.önekini arayın. - Varlık değerlerini ve güncelleme zamanlarını kontrol edin.
Sorun giderme
- Kimlik doğrulama hatası: Belirteci ve
Authorization: Bearer ...üst bilgisini kontrol edin. - Bağlantı başarısız: Temel URL’yi, bağlantı noktasını, ağ erişimini ve sertifika güvenini kontrol edin.
- Bazı okumalar eksik: Seçilen günü, kaynakları ve Etkinlik Günlüklerini inceleyin. Bir çalıştırma bazı varlıkları güncellerken diğerleri başarısız olabilir.
Başarısız adımları kontrol etmek için otomasyonu açın ve Etkinlik Günlüklerini Görüntüle’yi seçin. Destek için bkz. Yardım Alma.