Apple Health verilerini REST API'ye senkronize et

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: Uygulamaların iPhone kilitliyken sağlık verilerine erişmesine izin verilmez. 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 Arka Plan Uygulama Yenileme'ye bağlıdır ve şu durumlarda hemen çalışmayabilir:

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

Ö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:

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ı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 İstekler

JSON formatı kullanırken, tek bir yük yerine birden fazla istek üzerinden verileri toplu olarak göndermek için Toplu İstekler'i AÇIK konumuna getirin.

• AÇIK - Aşırı büyük yükleri önlemek için verileri birden fazla isteğe yayar
• KAPALI - Tüm verileri tek bir istekte gönderir

Senkronizasyon Sıklığı

Otomasyonun verileri ne sıklıkla yükleyeceğ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. Verilerin alındığını doğrulamak için endpoint'inizi 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

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

1. Performans:

   • Detay vs. veri boyutu dengesini sağlamak için uygun zaman gruplama kullanın
   • Yalnızca ihtiyacınız olan metrikleri seçin

2. 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

3. 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