Yardım Merkezi HealthyApps
Türkçe
Yardım Merkezi
Ana web sitesi ↗

Yardım konularını ara

Apple Health Verisini REST API’ye Senkronize Etme

Sağlık verisini bir REST API uç noktasına gönderin.

Son güncelleme: 31 Ekim 2026

Bu sayfada
Otomasyonu açmaAd, durum ve bildirimlerUç noktayı kurma
Veri Türü Ayarları Veri Türü Ayarları Sağlık metrikleriAntrenmanlar
Dışa Aktarma Ayarları Dışa Aktarma Ayarları Dışa Aktarma BiçimiDışa Aktarma SürümüTarih AralığıVerileri Özetle ve Zaman Gruplaması
Toplu istekler ve büyük yüklerHatırlatıcıları PlanlaSenkronizasyon Sıklığı ve kaydetmeİstek üst bilgileriGeçmiş veya kaçırılan veriyi dışa aktarmaSorun giderme

Sağlık dışa aktarımlarını HTTP POST isteklerini kabul eden bir uç noktaya gönderin.

Ö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 uç noktanıza başarılı bir yüklemeyi bildirir.

İstendiğinde bildirimlere izin verin. Bu bildirimler etkinliği bildirir; bir çalıştırmayı zamanlamaz.

Uç noktayı kurma

  1. Otomasyon Türü olarak REST API’yi seçin.
  2. iPhone veya iPad’inizden erişilebilir bir URL girin, örneğin https://api.example.com/health-data.
  3. Gerekli kimlik doğrulamayı HTTP Üst Bilgileri altına ekleyin. Örneğin anahtar olarak Authorization ve değer olarak Bearer YOUR_TOKEN kullanın.
  4. Uç noktanıza uygun bir İstek Zaman Aşımı seçin.

Her üst bilginin hem anahtarı hem değeri olmalıdır. Başka bir cihazdaki sunucu için localhost yerine erişilebilir ağ adresini kullanın.

Veri Türü Ayarları

Bu otomasyon için bir Veri Türü seçin: Sağlık Metrikleri, Antrenmanlar, Semptomlar, ECG, Kalp Atış Hızı Bildirimleri, Zihin Durumu, Döngü Takibi veya İlaçlar. Zihin Durumu iOS 18 veya sonrası gerektirir; İlaçlar iOS 26 veya sonrası ve ayrı ilaç erişimi gerektirir.

Sağlık metrikleri

Sağlık Metrikleri’ni seçin, ardından Sağlık Metriklerini Seç’i açın ve ihtiyacınız olan ölçümleri seçin.

Okumaları belirli uygulamalar veya cihazlarla sınırlamak için Tercih Edilen Kaynaklar’ı açın, bir metrik seçin ve kaynaklarını seçin. Tümü, hariç tutulmamış her kaynağa izin verir. Bu otomasyonun sağlık metriklerinde bir kaynağı yok saymak için Hariç Tutulan Kaynaklar’ı kullanın. Hariç tutmalar önceliklidir; tercih edilen kaynakta veri yoksa seçilmemiş bir kaynak yerine konmaz. Kaynak seçimlerini uygulamak için Kaydet’i, iptal etmek için İptal’i seçin.

Antrenmanlar

Antrenman kayıtlarını dışa aktarmak için Antrenmanlar’ı seçin. Rota Verisini Dahil Et JSON antrenman verisine kullanılabilir rota noktalarını ekler. Ayrı GPX yüklemeleri oluşturmaz.

Sürüm 2 için kalp atış hızı, aktif enerji ve adımlar gibi okumalar eklemek üzere Antrenman Metriklerini Dahil Et’i açın. Antrenman metriği Zaman Gruplaması için Dakikalar veya Saniyeler’i seçin; saniyeler daha fazla ayrıntı ve daha büyük dışa aktarmalar üretir. Sürüm 1 her zaman antrenman metriklerini içerir.

Dışa Aktarma Ayarları

Dışa Aktarma Biçimi

  • JSON entegrasyonlar ve analiz için yapılandırılmış veriyi korur.
  • CSV elektronik tablolar için tablo dosyaları oluşturur.
  • Markdown notlar ve arşivler için okunabilir başlıklar ve tablolar oluşturur.

Dışa Aktarma Sürümü

Güncel veri yapısı için Sürüm 2’yi seçin. Mevcut bir iş akışı eski biçime bağlıysa Sürüm 1’i kullanın.

Tarih Aralığı

Seçim Dahil edilen veri
Varsayılan Önceki gün ve çalıştırma zamanına kadar bugün
Son Senkronizasyondan Beri Önceki senkronizasyondan çalıştırma zamanına kadar
Bugün Çalıştırma zamanına kadar bugün
Dün Önceki tam gün
Önceki 7 Gün Önceki yedi tam gün

Verileri Özetle ve Zaman Gruplaması

JSON + Sağlık Metrikleri için okumaları zaman gruplarında birleştirmek üzere Verileri Özetle’yi açın veya desteklendiğinde bireysel okumalar için kapatın. Özet metriğe bağlıdır—örneğin adımlar toplanır ve kilo okumaları ortalanır. CSV sağlık metriği dışa aktarmaları özetlenmiş veri kullanır.

Zaman Gruplaması kullanılabilir olduğunda ne kadar ayrıntı tutulacağını seçin. Saatlik veya günlük gruplar, dakika veya saniye gruplarından daha az satır üretir. Kullanılabilir seçimler tarih aralığına ve biçime bağlıdır. Antrenman zaman gruplaması Antrenmanlar altında ayrı yapılandırılır.

Toplu istekler ve büyük yükler

REST API + JSON için veriyi birden fazla istekte göndermek üzere Toplu İstekler’i açın. Uç noktanız büyük gövdeleri reddettiğinde veya büyük istekler zaman aşımına uğradığında bunu kullanın. Alıcı hizmet her isteği ayrı işlemelidir.

Toplu istek CSV ve Markdown için kullanılamaz. Bireysel isteklerin boyutunu azaltır ancak cihazın okuması gereken sağlık verisi miktarını azaltmaz. Hazırlık yavaşsa bkz. Performans.

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, Saatler, Günler veya Haftalar seçin—örneğin her 15 dakika. 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.

İstek üst bilgileri

Uygulama seçilen biçim için Content-Type ayarlar ve şunları içerir:

Üst bilgi Anlam
automation-name Otomasyon adı
automation-id Otomasyon tanımlayıcısı
automation-aggregation Seçilen zaman gruplaması
automation-period Seçilen tarih aralığı
session-id İstek tanımlayıcısı

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.

  1. Otomasyonu açın ve Mevcut Veriyi Dışa Aktar altında Manuel Yükleme’yi seçin.
  2. Başlangıç ve Bitiş tarihlerini ayarlayın, ardından Dışa Aktarmayı Başlat’ı seçin.
  3. Uç noktanızın aldığı isteği, üst bilgileri ve gövdeyi kontrol edin.

Sorun giderme

  • İstek alınmadı: URL’yi, ağ erişilebilirliğini ve sunucu günlüklerini kontrol edin.
  • Kimlik doğrulama hatası: Üst bilgi anahtarını, belirteci ve uç nokta izinlerini kontrol edin.
  • Yük reddedildi veya zaman aşımı: Sunucunun boyut sınırlarını kontrol edin, JSON için toplu istek kullanın veya dışa aktarma boyutunu küçültün.

Bir çalıştırmayı incelemek için otomasyonu açın ve Etkinlik Günlüklerini Görüntüle’yi seçin. Uyarılar yavaş veri alımı gibi olası sorunları işaret eder; hatalar başarısız adımları belirler. Bir sorunu bildirme konusunda yardım için bkz. Yardım Alma.