Apple Health verilerini REST API'ye senkronize et

Sağlık verilerini bir REST API endpoint'ine gönderin.

Last updated: June 9, 2026

Bu sayfada

REST API otomasyon kılavuzu

REST API otomasyonları, sağlık verilerinizi HTTP POST isteklerini kabul eden herhangi bir web servisine otomatik olarak dışa aktarmanıza olanak tanır. Bu, özel backend'ler, üçüncü taraf API'leri veya webhook'larla entegrasyon için idealdir.

Genel Bakış

REST API otomasyonları, sağlık verilerinizi HTTP POST istekleri kullanarak belirtilen bir URL endpoint'ine gönderir. Otomasyon, kimlik doğrulama ve özel metadata için yapılandırılabilir başlıklarla JSON veya CSV formatında veri gönderebilir.

Kullanım durumları:

Özel backend hizmetleriyle entegrasyon
Webhook'lara veri gönderme
Üçüncü taraf API'leriyle senkronizasyon
Özel panolar veya analitik platformlar oluşturma

Temel özellikler:

Hem JSON hem de CSV formatlarını destekler
Kimlik doğrulama için özel HTTP başlıkları
Yapılandırılabilir istek zaman aşımı
Geçmiş verilerin manuel dışa aktarımı

Sınırlamalar:

Sağlık verilerine erişim: iPhone kilitliyken uygulamaların sağlık verilerine erişmesine izin verilmez. Otomasyonlar yalnızca cihazınızın kilidi açıkken çalışır. Bu, Apple tarafından konulan ve aşılamayan bir sınırlamadır. Daha fazla bilgi
Arka plan işleme: iOS, pil ömrünü korumak için arka plan işlemeyi sınırlar. Otomasyonlar Arka Planda Uygulama Yenileme'ye bağlıdır ve şu durumlarda hemen çalışmayabilir:
- uygulama için Arka Planda Uygulama Yenileme devre dışıysa
- cihaz Düşük Güç Modu'ndaysa
- cihaz uzun süredir etkin değilse
- sistem kaynakları kısıtlıysa
- birden fazla uygulama arka plan yürütme süresi için yarışıyorsa

Performans

iOS'un kısa süreli görevler için çok sıkı performans kısıtlarıyla mobil cihazlarda optimize edildiğini unutmayın. Arka plan görevleri genellikle 30 saniye içinde tamamlanmalıdır ve bellek kullanımı sınırlıdır. Health Auto Export yüksek düzeyde esneklik ve özelleştirme sunar; bu nedenle belirli yapılandırmaların uygulama performansını ve sonuçları nasıl etkileyeceğini anlamak önemlidir.

Yapılandırma: Büyük miktarda veri üreten otomasyonlar, sistemin işlemi sonlandırmasına ve otomasyonların arka planda çalışmamasına neden olabilir. Aşağıdaki yapılandırmalar büyük miktarda veri üretebilir:
- Tüm sağlık metriklerini dışa aktarmak üzere yapılandırılmış otomasyonlar.
  - Öneri: yalnızca Apple Health'te kayıtlı verisi olan sağlık metriklerini ve gerçekten kullanmayı planladığınız verileri seçin. Boş veri türleri bile performansı etkiler. Seçilen sağlık metriklerini birden fazla otomasyona bölmeyi de düşünebilirsiniz — bu, sistemin işlemesini kolaylaştırır.
- Saniye veya dakika düzeyinde zaman gruplaması kullanan veya veri özetleme kapalı olan otomasyonlar. Bu kadar ayrıntılı sorgular uzun sürebilir ve sistem sınırlamalarıyla çakışabilir.
  - Öneri: mümkün olan en ayrıntılı veriye sahip olmak ideal görünse de, bu ayrıntı düzeyinin her metrik veya veri türü için gerekli olup olmadığını düşünün. Farklı ayarlarla birden fazla otomasyonu değerlendirin.
- Bisiklet, koşu, yürüyüş vb. açık hava antrenmanlarını rota verileriyle dışa aktarırken GPS ve ilişkili sağlık metrikleri büyük veri yükleri oluşturabilir.
Veri yükü boyutu: Özellikle REST API dışa aktarmasında büyük veri yüklerinin sunucu hatalarına yol açabileceğini unutmayın. Arka ucunuzun birkaç yüz megabayta kadar veri yüklerini işleyebilecek şekilde yapılandırıldığından emin olun.
Senkronizasyon sıklığı: Otomasyonların arka planda daha güvenilir çalışması için Otomasyonlar widget'ını Ana Ekranınıza ekleyin (bkz. Otomasyonlar Widget Kurulum Kılavuzu).

Önkoşullar

HTTP POST isteklerini kabul eden geçerli bir URL endpoint'i
Kimlik doğrulama kimlik bilgileri (endpoint'iniz tarafından gerekliyse)
Endpoint'inize ulaşmak için ağ bağlantısı

Yapılandırma

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

Otomasyon Adı

Otomasyonunuz için açıklayıcı bir ad girin (ör. "Backend API'm", "Webhook Entegrasyonu").

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

URL Yapılandırması

Sağlık verilerinizi göndermek istediğiniz tam URL'yi girin. Bu, protokolü (http:// veya https://) içeren tam bir URL olmalıdır.

Örnek URL'ler:

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

Not: URL geçerli olmalı ve cihazınızdan erişilebilir olmalıdır. Geçersiz URL'ler otomasyonun çalışmasını engelleyecektir.

İstek Zaman Aşımı

HTTP istekleri için bir zaman aşımı aralığı seçin. Bu, uygulamanın isteğin başarısız sayılmadan önce bir yanıt için ne kadar bekleyeceğini belirler.

HTTP Başlıkları

Kimlik doğrulama veya metadata için özel HTTP başlıkları ekleyin. Yaygın kullanım durumları şunları içerir:

API anahtarları: X-API-Key: your-api-key
Yetkilendirme token'ları: Authorization: Bearer your-token
İçerik türü geçersiz kılmaları: Content-Type: application/json

Başlık eklemek için:

"Başlık Ekle"ye dokunun
Başlık anahtarını sol alana girin
Başlık değerini sağ alana girin
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ılacaktır.

Veri Türü Ayarları

Veri Türü

Dışa aktarılacak sağlık verisi türünü seçin:

Sağlık Metrikleri - Adımlar, kalp atış hızı, uyku ve diğer sağlık ölçümleri
Antrenmanlar - Egzersiz ve fitness aktiviteleri
Semptomlar - Sağlık semptomları ve durumları
EKG - Elektrokardiyogram okumaları
Kalp Atış Hızı Bildirimleri - Yüksek/düşük kalp atış hızı olayları
Zihin Durumu - Ruh hali ve zihinsel durum girişleri (iOS 18.0+)
Döngü Takibi - Adet döngüsü ve üreme sağlığı verileri
İlaçlar - İlaç günlükleri ve uyumluluk (iOS 26.0+)

Sağlık Metrikleri Yapılandırması

Sağlık Metrikleri seçildiğinde:

Sağlık Metriklerini 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 veri boyutunu azaltabilir.

Tercih Edilen Kaynaklar - Birden fazla kaynak aynı metriği sağladığında hangi veri kaynaklarının öncelik alacağını yapılandırın.

Antrenman Yapılandırması

Antrenmanlar seçildiğinde:

Rota Verilerini Dahil Et - Konum verilerine sahip antrenmanlar için rotaları dahil etmek üzere AÇIK konumuna getirin.

Antrenman Metriklerini Dahil Et - Antrenmanlar sırasında toplanan sağlık metriklerini (kalp atış hızı, kalori vb.) dahil etmek üzere AÇIK konumuna getirin.

Zaman Gruplama (Antrenman Metrikleri) - Dışa Aktarma Sürümü 2 kullanılırken ve Antrenman Metriklerini Dahil Et etkinleştirildiğinde:

Dakikalar - Antrenman metriklerini dakikaya göre gruplar
Saniyeler - Antrenman metriklerini saniyeye göre gruplar

Dışa Aktarma Ayarları

Dışa Aktarma Formatı

Dışa aktarılan verileriniz için formatı seçin:

JSON formatı - İç içe nesnelerle detaylı veri yapıları sağlar. Yapılandırılmış verilere ihtiyaç duyan API'ler, veritabanları ve uygulamalar için en iyisi. JSON formatı, uyku fazları ve AFib okumaları gibi karmaşık veri türleri için daha detaylı bilgiler içerir.
CSV formatı - Elektronik tablo uygulamalarına kolayca aktarılabilen tablo verileri sağlar. Basit veri analizi veya endpoint'inizin CSV verisi beklediği durumlar için en iyisi.

Not: Content-Type başlığı JSON dışa aktarmaları için otomatik olarak application/json ve CSV dışa aktarmaları için multipart/form-data olarak ayarlanır.

Dışa Aktarma Sürümü

Bir Dışa Aktarma Sürümü seçin. Sürüm oluşturma, dışa aktarmanın güncellenmiş sürümleri arasında kendi hızınızda geçiş yapmanıza olanak tanır ve iş akışlarını bozan değişiklikleri en aza indirir.

Sürüm 1 - Eski format, bu formata bağımlı mevcut iş akışlarınız varsa kullanın
Sürüm 2 - Geliştirilmiş antrenman verileri ve daha detaylı metadata seçenekleriyle güncel format

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 olan verileri senkronize eder
Son Senkronizasyondan Beri - Her senkronizasyonda, dışa aktarmanın son çalıştırıldığı zamandan mevcut tarih ve saate kadar tüm verileri dışa aktarır
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
Son 7 Gün - Son yedi günün tamamı için verileri senkronize eder

Verileri Özetle

Sağlık Metrikleri veri türüyle JSON formatı kullanırken, Verileri Özetle'yi AÇIK veya KAPALI konumuna getirin.

AÇIK - Toplanmış veri özetleri sağlar
KAPALI - Mümkün olduğunda ayrıştırılmış veriler sağlar, bireysel veri noktalarını gösterir

Not: Bu ayar yalnızca Sağlık Metrikleri ile JSON formatı için geçerlidir. CSV formatı kullanıldığında veya birden fazla metrik seçildiğinde veriler her zaman toplanır.

Zaman Gruplama

Verileri Özetle etkinleştirilmiş JSON formatı kullanırken, verilerin nasıl toplanacağını seçin.

Not: CSV formatı her zaman verileri toplar. Dakika ve saniye düzeyinde toplama, işleme süresini ve veri boyutunu önemli ölçüde artırabilir.

Toplu istekler ve büyük yükler

JSON formatında, tek büyük yük yerine birden fazla HTTP isteğinde veri göndermek için Toplu İstekleri açın.

AÇIK — Veriyi birden fazla isteğe yayar. Uç noktanızda yük boyutu sınırı, büyük gövdelerde zaman aşımı veya artımlı işleme varsa kullanın.
KAPALI — Tüm veriyi tek istekte gönderir. Küçük dışa aktarmalar ve basit webhooklar için uygundur.

Toplu işlem ne zaman açılır:

Çok sayıda sağlık metriği, uzun tarih aralıkları veya ince zaman gruplaması (dakika/saniye)
Verileri özetle KAPALI ve ayrıştırılmış sağlık metrikleri dışa aktarıyorsanız
Sunucu büyük POST gövdelerinde hata veya zaman aşımı döndürüyorsa

Notlar:

Toplu istekler yalnızca REST API + JSON için geçerlidir (CSV değil).
Toplu işlem istek başına yükü azaltır ancak cihazda veri getirmeyi kaldırmaz; yavaş HealthKit sorguları etkinlik günlüklerinde uyarı olarak görünebilir. Bkz. Etkinlik günlüklerinde yavaş sorgular.

Test ve Doğrulama

Veri Formatını Doğrulama

Uygulama her istekte otomatik olarak şu başlıkları içerir:

Content-Type - Dışa aktarma formatına göre ayarlanır
automation-name - Otomasyonunuzun adı
automation-id - Otomasyon için benzersiz tanımlayıcı
automation-aggregation - Seçilen zaman gruplama
automation-period - Seçilen tarih aralığı
session-id - Her istek için benzersiz tanımlayıcı

Sorun Giderme

Yaygın Sorunlar

Endpoint'te Veri Alınmadı

Endpoint URL'sinin doğru olduğunu doğrulayın
Endpoint'inizin POST isteklerini kabul ettiğini kontrol edin
Kimlik doğrulama başlıklarını gözden geçirin
Gelen istekler için endpoint günlüklerini kontrol edin
Ağ bağlantısını doğrulayın

İpuçları ve En İyi Uygulamalar

Otomatik senkronizasyon:
- Cihazı şarj edin ve iPhone Yansıtma kullanın
  - Şarj sırasında iOS daha az performans kısıtlaması uygular, böylece veriler daha sık senkronize edilebilir
  - iPhone Yansıtma ile cihaz kilidi açılmış gibi davranır. Health Auto Export sağlık verilerine erişip otomatik işlemleri çalıştırabilir
Performans:
- Detay vs. veri boyutu dengesini sağlamak için uygun zaman gruplama kullanın
- Yalnızca ihtiyacınız olan metrikleri seçin
Güvenilirlik:
- Endpoint'inizin yanıt süresine göre uygun zaman aşımı değerleri ayarlayın
- Etkinlik günlüklerini düzenli olarak izleyin
Veri Formatı:
- Yapılandırılmış veriler ve API'ler için JSON kullanın
- Basit veri analizi veya elektronik tablo entegrasyonu için CSV kullanın
- Büyük veri kümeleri veya ayrı işleme için toplu istekleri düşünün

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

Otomasyon yapılandırma ekranında Etkinlik günlüklerini görüntüle öğesine dokunun.
çalıştırmalar öğelerini inceleyin (gruplandırılmış, en yeni önce) ve her çalıştırmadaki olayları genişletin.
uyarılar (ör. yavaş sağlık verisi sorgusu) ile hatalar (HTTP hataları, zaman aşımları veya HealthKit okuma hataları) arasında ayrım yapın—bkz. Otomasyonlara genel bakış — Etkinlik günlükleri.
Başarılı REST yüklemeleri genellikle çalıştırmada biçim, veri türü, dışa aktarma dönemi ve tarih aralığı içeren bir özet gösterir.
Paylaş (araç çubuğu), destek için tam Uygulama olay günlükleri tanı ZIP’ini dışa aktarır (Ayarlar → Gelişmiş ile aynı).
Temizle yalnızca bu otomasyonun etkinlik geçmişini kaldırır.