HealthyApps Help Center

Automasi Pautan Dalam

Cipta automasi secara pengaturcaraan menggunakan skema URL.

Last updated: February 5, 2026

Pada halaman ini

Automasi pautan dalam membolehkan anda membuat automasi REST API secara pemrograman menggunakan skema URL. Ini sesuai untuk skrip automasi, pengurusan konfigurasi atau penyepaduan dengan sistem luaran yang perlu mengkonfigurasi eksport data kesihatan.

Gambaran Keseluruhan

Automasi pautan dalam menggunakan skema URL tersuai untuk mencipta dan mengkonfigurasi automasi REST API tanpa memasukkan tetapan secara manual dalam apl. Apabila anda membuka URL pautan dalam, apl mencipta automasi baharu secara automatik dengan konfigurasi yang ditentukan.

Kes Penggunaan:

  • Persediaan automasi program daripada skrip atau alatan
  • Konfigurasi automasi pukal
  • Integrasi dengan sistem pengurusan konfigurasi
  • Persediaan pantas daripada aplikasi luaran atau tapak web
  • Pengujian dan aliran kerja pembangunan

Ciri Utama:

  • Buat automasi melalui skema URL
  • Konfigurasikan semua tetapan automasi REST API
  • Pengesahan parameter selamat jenis
  • Mesej ralat yang komprehensif

Keterbatasan

  • Pautan dalam hanya menyokong automasi REST API (bukan Dropbox, Google Drive, dll.)
  • Had panjang URL mungkin menyekat senarai parameter yang sangat panjang
  • Semua had daripada automasi REST API dikenakan (pemprosesan latar belakang, akses data kesihatan, dsb.)

Format URL

URL pautan dalam mengikuti struktur ini:

com.HealthExport://automation?parameter1=value1&parameter2=value2&...

URL asas: com.HealthExport://automation

Parameter: Semua parameter adalah pilihan kecuali name dan url. Parameter adalah tidak peka huruf besar-besaran.

Rujukan Parameter

Parameter yang Diperlukan

url (diperlukan)

  • Jenis: Rentetan (URL yang sah)
  • Penerangan: URL titik akhir tempat data kesihatan akan dihantar
  • Contoh: https://api.example.com/health-data
  • Nota: Mestilah URL HTTP/HTTPS yang sah

name (diperlukan)

  • Jenis: Rentetan
  • Penerangan: Nama deskriptif untuk automasi
  • Contoh: My%20Backend%20API (berkod URL: My Backend API")
  • Nota: Mesti dikodkan URL jika ia mengandungi ruang atau aksara khas

Konfigurasi Asas

format

  • Jenis: Enum (json, csv)
  • Lalai: json
  • Penerangan: Format eksport untuk data
  • Contoh: format=json atau format=csv
  • Nota: Format CSV mendayakan pengagregatan data secara automatik

enabled

  • Jenis: Boolean (true, false, 1, 0, yes, no)
  • Lalai: false
  • Penerangan: Sama ada automasi didayakan serta-merta selepas penciptaan
  • Contoh: enabled=true

datatype

  • Jenis: Enum (lihat Jenis Data di bawah)
  • Lalai: healthMetrics
  • Penerangan: Jenis data kesihatan untuk dieksport
  • Contoh: datatype=workouts
  • Nota: Hanya satu jenis data boleh dipilih. Menetapkan ini secara automatik mengkonfigurasi bendera termasuk yang sesuai.

Jenis Data Sah:

  • healthMetrics - ​​Metrik kesihatan (langkah, kadar denyutan jantung, tidur, dsb.)
  • workouts - ​​Aktiviti senaman dan kecergasan
  • symptoms - ​​Gejala dan keadaan kesihatan
  • ecg - ​​Bacaan elektrokardiogram
  • heartRateNotification - ​​Peristiwa kadar denyutan jantung tinggi/rendah
  • stateOfMind - ​​Entri mood dan keadaan mental (iOS 18.0+)
  • cycleTracking - ​​Kitaran haid dan data kesihatan reproduktif
  • medications - ​​Log ubat dan pematuhan (iOS 26.0+)

Tetapan Eksport

period

  • Jenis: Enum
  • Lalai: none
  • Penerangan: Julat tarikh untuk eksport data
  • Contoh: period=today

Nilai Sah:

  • none - ​​Lalai (penuh hari sebelumnya ditambah hari semasa)
  • lastsync - ​​Sejak penyegerakan terakhir
  • today - ​​Hari semasa
  • yesterday - ​​Hari sebelumnya
  • previous7days - ​​7 hari sebelumnya
  • realtime - ​​Kemas kini masa nyata (memerlukan selang penyegerakan saat)

interval

  • Jenis: Enum
  • Lalai: none
  • Penerangan: Selang kumpulan masa/pengagregatan (hanya sah untuk jenis data healthMetrics)
  • Contoh: interval=hours

Nilai Sah:

  • none - ​​Lalai (tiada pengagregatan)
  • minutes - ​​Kumpulan mengikut minit
  • hours - ​​Kumpulan mengikut jam
  • days - ​​Kumpul mengikut hari
  • weeks - ​​Kumpulan mengikut minggu
  • months - ​​Kumpulan mengikut bulan
  • years - ​​Kumpulan mengikut tahun

Nota: Parameter ini hanya sah apabila datatype=healthMetrics. Format CSV sentiasa mengagregatkan data.

aggregatedata

  • Jenis: Boolean
  • Lalai: true (untuk CSV), false (untuk JSON)
  • Penerangan: Sama ada hendak mengagregatkan/meringkaskan data (hanya sah untuk healthMetrics dengan format JSON)
  • Contoh: aggregatedata=true
  • Nota: Tetapkan secara automatik kepada true apabila format=csv

aggregatesleep

  • Jenis: Boolean
  • Lalai: true
  • Penerangan: Sama ada hendak mengagregat data tidur
  • Contoh: aggregatesleep=true

exportversion

  • Jenis: Enum (v1, v2, 1, 2)
  • Lalai: v2
  • Penerangan: Versi format eksport
  • Contoh: exportversion=v2
  • Nota: Versi 2 termasuk data senaman yang dipertingkatkan dan metadata yang lebih terperinci

batchrequests

  • Jenis: Boolean
  • Lalai: false
  • Penerangan: Hantar data dalam kelompok atas berbilang permintaan (hanya sah untuk REST API dengan format JSON)
  • Contoh: batchrequests=true
  • Nota: Hanya sah apabila format=json dan exportDestination=restApi

Irama Segerak

syncinterval

  • Jenis: Enum
  • Lalai: minutes
  • Penerangan: Selang untuk irama penyegerakan
  • Contoh: syncinterval=hours

Nilai Sah:

  • minutes - ​​Segerakkan setiap N minit
  • hours - ​​Segerakkan setiap N jam
  • days - ​​Segerakkan setiap N hari
  • weeks - ​​Segerakkan setiap N minggu
  • seconds - ​​Hanya sah apabila period=realtime

Nota: Untuk automasi REST API, hanya minutes, hours, days dan weeks adalah sah melainkan menggunakan eksport masa nyata.

syncquantity

  • Jenis: Integer (positif)
  • Lalai: 5
  • Penerangan: Bilangan selang antara penyegerakan
  • Contoh: syncquantity=10 (segerakkan setiap 10 minit jika syncinterval=minit)
  • Nota: Mesti lebih besar daripada 0

Konfigurasi HTTP

headers

  • Jenis: Rentetan (pasangan nilai kunci yang dipisahkan koma)
  • Lalai: Tiada
  • Penerangan: Pengepala HTTP untuk pengesahan atau metadata
  • Contoh: headers=Authorization,Bearer%20token123,X-API-Key,abc123
  • Format: key1,value1,key2,value2,...
  • Nota: Nilai hendaklah dikodkan URL. Setiap pengepala memerlukan kedua-dua kunci dan nilai.

Contoh Pengepala:

  • Authorization, Bearer your-token
  • X-API-Key, your-api-key
  • Content-Type, application/json

requesttimeout

  • Jenis: Integer (60-86400)
  • Lalai: 60
  • Penerangan: Minta tamat masa dalam beberapa saat
  • Contoh: requesttimeout=300
  • Nota: Mesti antara 60 dan 86400 saat (1 minit hingga 24 jam)

Tetapan Khusus Jenis Data

Tetapan Metrik Kesihatan

metrics
  • Jenis: Rentetan (MetricName dipisahkan koma rawValues)
  • Lalai: Semua metrik tersedia
  • Penerangan: Metrik kesihatan khusus untuk disertakan (hanya sah untuk jenis data healthMetrics)
  • Contoh: metrics=Step%20Count,Heart%20Rate,Active%20Energy
  • Nota: Mesti menggunakan rawValues ​​MetricName tepat. Jika tidak dinyatakan, semua metrik yang tersedia disertakan.

Nama Metrik Biasa:

  • Step Count
  • Heart Rate
  • Active Energy
  • Apple Exercise Time
  • Sleep Analysis
  • Walking + Running Distance

Lihat skrin pemilihan metrik apl untuk mendapatkan senarai lengkap metrik yang tersedia.

Tetapan Senaman

includeroutes
  • Jenis: Boolean
  • Lalai: true
  • Penerangan: Sertakan data laluan untuk senaman (hanya sah untuk jenis data senaman)
  • Contoh: includeroutes=true
includeworkoutmetadata
  • Jenis: Boolean
  • Lalai: true
  • Penerangan: Sertakan metrik senaman (denyut jantung, kalori, dll.) yang dikumpul semasa bersenam (hanya sah untuk jenis data senaman)
  • Contoh: includeworkoutmetadata=true
workoutsmetadatainterval
  • Jenis: Enum (minutes, seconds)
  • Lalai: minutes
  • Penerangan: Pengumpulan masa untuk metrik senaman (hanya sah untuk jenis data senaman dengan exportVersion v2)
  • Contoh: workoutsmetadatainterval=seconds
  • Nota: Hanya sah apabila datatype=workouts dan exportversion=v2
workouttypes
  • Jenis: Rentetan (nilai UInt yang dipisahkan koma)
  • Lalai: Kosong (semua jenis senaman)
  • Penerangan: Jenis senaman khusus untuk disertakan (hanya sah untuk jenis data senaman)
  • Contoh: workouttypes=1,2,3
  • Nota: Menggunakan pengecam jenis senaman HealthKit

Pemberitahuan

notifyonupdate

  • Jenis: Boolean
  • Lalai: true
  • Penerangan: Terima pemberitahuan apabila data cache dikemas kini
  • Contoh: notifyonupdate=true

notifywhenrun

  • Jenis: Boolean
  • Lalai: true
  • Penerangan: Terima pemberitahuan setiap kali automasi dilaksanakan
  • Contoh: notifywhenrun=false

Contoh

Automasi API REST Asas

com.HealthExport://automation?url=https://api.example.com/health&name=My%20Automation&format=json&enabled=true

Mencipta automasi asas yang menghantar data JSON ke titik akhir yang ditentukan.

Dengan Pengepala Pengesahan

com.HealthExport://automation?url=https://api.example.com/health&name=Authenticated%20API&format=json&headers=Authorization,Bearer%20your-token-here,X-API-Key,abc123&enabled=true

Mencipta automasi dengan pengepala pengesahan tersuai.

Metrik Kesihatan dengan Metrik Khusus

com.HealthExport://automation?url=https://api.example.com/metrics&name=Steps%20and%20Heart%20Rate&format=json&datatype=healthMetrics&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours&enabled=true

Mencipta automasi yang hanya mengeksport langkah dan kadar denyutan jantung, diagregatkan mengikut jam.

Latihan dengan Data Laluan

com.HealthExport://automation?url=https://api.example.com/workouts&name=Workout%20Export&format=json&datatype=workouts&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes&enabled=true

Mencipta automasi untuk senaman dengan data laluan dan metrik senaman, menggunakan versi eksport 2.

Contoh Konfigurasi Lengkap

com.HealthExport://automation?url=https://api.example.com/health-data&name=Complete%20Configuration&format=json&datatype=healthMetrics&period=today&interval=hours&aggregatedata=true&aggregatesleep=true&exportversion=v2&syncinterval=hours&syncquantity=2&headers=Authorization,Bearer%20token123&requesttimeout=300&batchrequests=true&notifyonupdate=true&notifywhenrun=false&enabled=true

Contoh komprehensif dengan semua parameter utama dikonfigurasikan.

Contoh Format CSV

com.HealthExport://automation?url=https://api.example.com/csv&name=CSV%20Export&format=csv&datatype=healthMetrics&period=yesterday&enabled=true

Mencipta automasi eksport CSV. Harap maklum bahawa format CSV mendayakan pengagregatan data secara automatik.

Pengekodan URL

Aksara khas dalam nilai parameter mestilah dikodkan URL. Pengekodan biasa:

  • Ruang: %20
  • Koma: %2C
  • Kolon: %3A
  • Titik bertitik: %3B
  • Sama dengan: %3D
  • Ampersand: %26
  • Tambahan: %2B

Contoh:

  • Asal: My Automation Name
  • Dikodkan: My%20Automation%20Name

Contoh Tajuk:

  • Asal: Authorization, Bearer token123
  • Dikodkan: Authorization,Bearer%20token123

Kebanyakan bahasa pengaturcaraan dan alatan menyediakan fungsi pengekodan URL:

  • Pantas: addingPercentEncoding(withAllowedCharacters:)
  • JavaScript: encodeURIComponent()
  • Python: urllib.parse.quote()

Menguji Pautan Dalam

Daripada Safari (iOS)

  1. Buka Safari pada peranti iOS anda
  2. Masukkan URL pautan dalam dalam bar alamat
  3. Ketik Pergi
  4. Apl harus membuka dan mencipta automasi

Dari Terminal (Simulator macOS/iOS)

xcrun simctl openurl booted "com.HealthExport://automation?url=https://api.example.com/health&name=Test&enabled=true"

Daripada Xcode

Tambahkan titik putus atau gunakan konsol penyahpepijat:

let url = URL(string: "com.HealthExport://automation?url=https://api.example.com/health&name=Test&enabled=true")!
try DataModel.shared.handleAPIDeepLink(url)

Daripada Apl Pintasan

  1. Cipta pintasan baharu
  2. Tambahkan tindakan "URL Terbuka".
  3. Masukkan URL pautan dalam anda
  4. Jalankan pintasan

Menyelesaikan masalah

Isu Biasa

"Tidak dapat menghuraikan URL"

  • Sahkan skema URL adalah betul: com.HealthExport://automation
  • Semak sama ada semua nilai parameter dikodkan URL dengan betul
  • Pastikan nama parameter dieja dengan betul (tidak sensitif huruf besar-besaran)

"Nilai parameter URL tidak sah"

  • Sahkan URL ialah URL HTTP/HTTPS yang sah
  • Semak pengekodan URL yang betul
  • Pastikan URL tidak mengandungi aksara yang tidak sah

"Jenis data tidak sah"

  • Gunakan nilai jenis data tepat: healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking, medications
  • Semak ejaan dan huruf besar (walaupun padanan tidak peka huruf besar-besaran disokong)

"Selang kaden penyegerakan tidak sah"

  • Untuk REST API, gunakan sahaja: minutes, hours, days, weeks
  • Gunakan seconds hanya apabila period=realtime

"Tetapan pengagregatan hanya sah untuk jenis data healthMetrics"

  • Parameter aggregatedata dan interval hanya berfungsi dengan datatype=healthMetrics
  • Alih keluar parameter ini atau tukar jenis data

"Permintaan kelompok hanya sah untuk REST API dengan format JSON"

  • batchrequests hanya berfungsi apabila format=json
  • Tukar format kepada JSON atau alih keluar parameter batchrequests

"Tetapan senaman hanya sah untuk jenis data senaman"

  • includeroutes, includeworkoutmetadata, dan workoutsmetadatainterval hanya bekerja dengan datatype=workouts
  • Tukar jenis data kepada senaman atau alih keluar parameter ini

"Parameter metrik hanya sah untuk jenis data healthMetrics"

  • metrics parameter hanya berfungsi dengan datatype=healthMetrics
  • Tukar jenis data atau alih keluar parameter metrik

"Nama metrik tidak sah"

  • Gunakan MetricName rawValues ​​yang tepat (cth., "Kiraan Langkah", "Denyutan Jantung")
  • Semak ejaan dan huruf besar
  • Lihat skrin pemilihan metrik apl untuk nama yang sah

"Tamat masa permintaan tidak sah"

  • Mesti antara 60 dan 86400 saat
  • Gunakan nilai dalam julat ini

"Nama diperlukan untuk automasi"

  • Pastikan parameter name disertakan
  • Semak bahawa nilai tidak kosong selepas penyahkodan URL

Had Panjang URL

URL yang sangat panjang (terutama dengan banyak metrik atau pengepala) mungkin melebihi had sistem. Pertimbangkan:

  • Menggunakan lebih sedikit metrik dalam parameter metrics
  • Mengurangkan bilangan tajuk
  • Menggunakan nilai parameter yang lebih pendek jika boleh
  • Memisahkan konfigurasi kompleks kepada berbilang automasi yang lebih mudah

Keutamaan Parameter

Apabila berbilang parameter bercanggah:

  1. Pemilihan jenis data (datatype) ditetapkan semula secara automatik termasuk bendera
  2. Format CSV (format=csv) secara automatik menetapkan aggregatedata=true
  3. Tempoh masa nyata (period=realtime) memerlukan syncinterval=seconds
  4. Ralat pengesahan akan dibuang untuk kombinasi yang tidak serasi

Amalan Terbaik

  1. Penyegerakan Automatik (apabila automasi dicetuskan melalui pautan dalam):
  • Cas peranti anda dan gunakan iPhone Mirroring
  • Apabila peranti anda sedang dicas, iOS meletakkan kurang sekatan pada prestasi peranti, jadi data boleh disegerakkan dengan lebih kerap
  • Dengan menggunakan iPhone Mirroring, peranti anda berkelakuan dengan cara yang sama seperti ia tidak berkunci. Ini bermakna data kesihatan boleh diakses oleh Eksport Auto Kesihatan untuk menjalankan tindakan automatik
  1. Sentiasa nilai parameter pengekodan URL mengandungi aksara khas
  2. Uji dengan URL mudah dahulu, kemudian tambahkan kerumitan
  3. Gunakan nama deskriptif untuk pengenalan lebih mudah
  4. Sahkan URL sebelum membuat pautan dalam secara pengaturcaraan
  5. Kendalikan ralat dengan anggun semasa menghuraikan pautan dalam
  6. Dokumenkan format pautan dalam anda jika membina alatan yang menjananya
  7. Pertimbangkan panjang URL apabila menyertakan banyak metrik atau pengepala
  8. Uji pada peranti sebenar serta simulator

Dokumentasi Berkaitan

Sokongan

Jika anda menghadapi isu yang tidak diliputi dalam panduan ini:

  1. Semak mesej ralat untuk isu parameter tertentu
  2. Sahkan pengekodan URL anda adalah betul
  3. Uji dengan URL minimum dahulu
  4. Gunakan butang Sokongan Sembang dalam apl untuk mendapatkan bantuan