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
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=healthMetricsile kullanın. - Antrenman ayarları hatası: Antrenman seçeneklerini
datatype=workoutsile kullanın; saniye gruplaması Sürüm 2 gerektirir. - Toplu istek hatası:
format=jsonayarlayın veyabatchrequests’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.