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

Yardım konularını ara

Derin Bağlantı Otomasyonu

iPhone veya iPad’inizde bir URL açarak bir REST API otomasyonu oluşturun.

Son güncelleme: 31 Ekim 2026

Bu sayfada
URL biçimi
Parametre başvurusu Parametre başvurusu Temel ayarlarSağlık metrikleriAntrenmanlarRitim ve bildirimler
Kimlik doğrulama ve kodlama
Örnekler Örnekler Seçili metrikler, saatlik özetlenmişRotalı antrenmanlar
Sorun gidermeİlgili belgeler

iPhone veya iPad’inizde bir URL açarak bir REST API otomasyonu oluşturun. Derin bağlantılar diğer hedefleri yapılandırmaz.

URL biçimi

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export

url zorunludur. Açıklayıcı bir name sağlayın; atlanırsa varsayılan Automation olur. Parametre adları büyük/küçük harfe duyarsızdır. Boşluk veya ayrılmış karakter içeren parametre değerlerini URL olarak kodlayın.

URL’yi cihazınızda açın veya Kısayollar’da URL’leri Aç’ı kullanın. Etkinleştirmeden önce oluşturulan otomasyonu Health Auto Export’ta gözden geçirin.

Parametre başvurusu

Boole değerler true/false, 1/0 veya yes/no kabul eder. Sonraki seçimlerin önceki ayarları değiştirmemesi için datatype’ı veriye özgü seçeneklerinden önce, format’ı da aggregatedata’dan önce ayarlayın.

Temel ayarlar

Parametre Değerler veya anlam Varsayılan
url Cihazınızdan erişilebilir uç nokta URL’si Zorunlu
name Boş olmayan otomasyon adı Automation
enabled Otomatik çalıştırmaları etkinleştir false
datatype Aşağıda listelenen veri türü healthMetrics
format json, csv, markdown veya md json
exportversion v1, v2, 1 veya 2 v2
period none, lastsync, today, yesterday, previous7days none
requesttimeout Tamsayı saniye, 60–86400 60
headers Virgülle ayrılmış anahtar/değer çiftleri Yok
batchrequests Boole; yalnızca JSON false

Geçerli veri türleri healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking ve medications’tır. State of Mind iOS 18 veya sonrası gerektirir; ilaç dışa aktarmaları iOS 26 veya sonrası gerektirir.

Tarih aralığı anlamları için bkz. Tarih aralığı. Tüm derin bağlantılar REST API otomasyonları oluşturur; exportDestination parametresi yoktur.

Sağlık metrikleri

Parametre Değerler veya anlam Varsayılan
metrics Virgülle ayrılmış tam metrik adları, örneğin Step Count,Heart Rate Tüm kullanılabilir metrikler
aggregatedata Boole; desteklendiğinde bireysel okumalar için false kullanın true
interval none, minutes, hours, days, weeks, months, years none
aggregatesleep Uyku özetlemesini kontrol eden boole true

metrics, aggregatedata ve interval sağlık metriklerine uygulanır. CSV seçimi özetlemeyi açar; bireysel okumalar için JSON kullanın. Bağlantı üretirken istenen özetlemeyi açıkça belirtin.

Antrenmanlar

Parametre Değerler veya anlam datatype=workouts iken varsayılan
includeroutes Boole true
includeworkoutmetadata Boole true
workoutsmetadatainterval minutes veya seconds; Sürüm 2 minutes
workouttypes Virgülle ayrılmış işaretsiz Apple antrenman türü tanımlayıcıları Tüm türler

Bir antrenman bağlantısına sağlık metriği toplama seçeneklerini eklemeyin.

Ritim ve bildirimler

Parametre Değerler veya anlam Varsayılan
syncinterval minutes, hours, days, weeks minutes
syncquantity Aralıkların pozitif tamsayı sayısı 5
notifyonupdate Boole; veri hazırlığından sonra bildir true
notifywhenrun Boole; başarılı bir hedef eyleminden sonra bildir true

Ritim arka plan ve sağlık verisi sınırlarına bağlı kalır; kesin bir zamanlama değildir.

Kimlik doğrulama ve kodlama

headers değeri dönüşümlü anahtar ve değerlerden oluşur:

headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY

Her anahtarın bir değeri olmalıdır. Virgüller çiftleri ayırır; bu nedenle bu bağlantı biçiminde virgül içeren üst bilgi değerlerinden kaçının. Boşlukları %20, artı işaretlerini %2B ve ve işaretlerini %26 olarak kodlayın. Kendi sorgu parametreleri olan uç nokta URL’sinin tamamını kodlayın.

Örnekler

Seçili metrikler, saatlik özetlenmiş

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fmetrics&name=Steps%20and%20Heart%20Rate&datatype=healthMetrics&format=json&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours

Rotalı antrenmanlar

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fworkouts&name=Workout%20Export&datatype=workouts&format=json&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes

Her iki örnek de otomasyonu gözden geçirip etkinleştirene kadar otomatik çalıştırmaları kapalı bırakır.

Sorun giderme

  • URL veya parametre hatası: Minimal URL ile başlayın, yazımı ve kodlamayı kontrol edin, ardından seçenekleri tek tek ekleyin.
  • Geçersiz metrik: Boşluklar ve büyük/küçük harf dahil tam metrik adını kullanın.
  • Toplama hatası: Sağlık metriği seçeneklerini yalnızca datatype=healthMetrics ile kullanın.
  • Antrenman ayarları hatası: Antrenman seçeneklerini datatype=workouts ile kullanın; saniye gruplaması Sürüm 2 gerektirir.
  • Toplu istek hatası: format=json ayarlayın veya batchrequests’i kapatın.
  • Geçersiz ritim/zaman aşımı: Desteklenen aralıkları, pozitif bir miktarı ve 60 ile 86400 saniye arasında bir zaman aşımını kullanın.
  • URL çok uzun: Metrik/üst bilgi listesini azaltın veya kalan ayarları uygulamada yapılandırın.

Oluşturmadan sonra seçili bir aralığı yüklemek veya kurulumunuzu kontrol etmek için REST API — Geçmiş veya kaçırılan veriyi dışa aktarma kullanın.

İlgili belgeler