Automasi Deep Link

Cipta automasi REST API dengan membuka URL pada iPhone atau iPad anda. Deep link tidak mengkonfigurasi destinasi lain.

Format URL

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

url diperlukan. Berikan name yang deskriptif; jika ditinggalkan, ia lalai kepada Automation. Nama parameter tidak peka huruf besar/kecil. Enkod URL nilai parameter yang mengandungi ruang atau aksara terpelihara.

Buka URL pada peranti anda, atau gunakan Buka URL dalam Pintasan. Semak automasi yang dicipta dalam Health Auto Export sebelum mendayakannya.

Rujukan parameter

Boolean menerima true/false, 1/0, atau yes/no. Tetapkan datatype sebelum pilihan khusus datanya, dan format sebelum aggregatedata, supaya pilihan kemudian tidak menggantikan tetapan sebelumnya.

Tetapan asas

Parameter	Nilai atau makna	Lalai
url	URL titik akhir yang boleh dicapai dari peranti anda	Diperlukan
name	Nama automasi tidak kosong	Automation
enabled	Dayakan jalanan automatik	false
datatype	Jenis data yang disenaraikan di bawah	healthMetrics
format	json, csv, markdown, atau md	json
exportversion	v1, v2, 1, atau 2	v2
period	none, lastsync, today, yesterday, previous7days	none
requesttimeout	Saat integer, 60–86400	60
headers	Pasangan kunci/nilai dipisahkan koma	Tiada
batchrequests	Boolean; JSON sahaja	false

Jenis data yang sah ialah healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking, dan medications. Keadaan Minda memerlukan iOS 18 atau lebih baharu; eksport ubat memerlukan iOS 26 atau lebih baharu.

Untuk makna julat tarikh, lihat Julat tarikh. Semua deep link mencipta automasi REST API; tiada parameter exportDestination.

Metrik kesihatan

Parameter	Nilai atau makna	Lalai
metrics	Nama metrik tepat dipisahkan koma, seperti Step Count,Heart Rate	Semua metrik tersedia
aggregatedata	Boolean; gunakan false untuk bacaan individu di mana disokong	true
interval	none, minutes, hours, days, weeks, months, years	none
aggregatesleep	Boolean yang mengawal peringkasan tidur	true

metrics, aggregatedata, dan interval terpakai kepada metrik kesihatan. Pemilihan CSV menghidupkan peringkasan; gunakan JSON untuk bacaan individu. Nyatakan peringkasan yang diingini secara eksplisit apabila menjana pautan.

Senaman

Parameter	Nilai atau makna	Lalai apabila datatype=workouts
includeroutes	Boolean	true
includeworkoutmetadata	Boolean	true
workoutsmetadatainterval	minutes atau seconds; Versi 2	minutes
workouttypes	Pengecam jenis senaman Apple tidak bertanda dipisahkan koma	Semua jenis

Jangan sertakan pilihan pengagregatan metrik kesihatan dalam pautan senaman.

Rentak dan pemberitahuan

Parameter	Nilai atau makna	Lalai
syncinterval	minutes, hours, days, weeks	minutes
syncquantity	Integer positif bilangan selang	5
notifyonupdate	Boolean; beritahu selepas penyediaan data	true
notifywhenrun	Boolean; beritahu selepas tindakan destinasi berjaya	true

Rentak kekal tertakluk kepada had latar belakang dan data kesihatan; ia bukan jadual yang tepat.

Pengesahan dan pengekodan

Nilai headers terdiri daripada kunci dan nilai berselang-seli:

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

Setiap kunci memerlukan nilai. Koma memisahkan pasangan, jadi elakkan nilai pengepala yang mengandungi koma dalam format pautan ini. Enkod ruang sebagai %20, tanda tambah sebagai %2B, dan ampersand sebagai %26. Enkod URL titik akhir lengkap apabila ia mempunyai parameter pertanyaan sendiri.

Contoh

Metrik dipilih, diringkaskan setiap jam

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

Senaman dengan laluan

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

Kedua-dua contoh meninggalkan jalanan automatik dilumpuhkan sehingga anda menyemak dan mendayakan automasi.

Penyelesaian masalah

• Ralat URL atau parameter: Mulakan dengan URL minimum, semak ejaan dan pengekodan, kemudian tambah pilihan satu demi satu.
• Metrik tidak sah: Gunakan nama metrik yang tepat, termasuk ruang dan huruf besar/kecil.
• Ralat pengagregatan: Gunakan pilihan metrik kesihatan hanya dengan datatype=healthMetrics.
• Ralat tetapan senaman: Gunakan pilihan senaman dengan datatype=workouts; pengumpulan saat memerlukan Versi 2.
• Ralat pengelompokan: Tetapkan format=json atau lumpuhkan batchrequests.
• Rentak/tamat masa tidak sah: Gunakan selang yang disokong, kuantiti positif, dan tamat masa dari 60 hingga 86400 saat.
• URL terlalu panjang: Kurangkan senarai metrik/pengepala atau konfigurasikan tetapan yang tinggal dalam aplikasi.

Selepas penciptaan, gunakan REST API — Mengeksport data sejarah atau terlepas untuk memuat naik julat yang dipilih atau menyemak persediaan.

Dokumentasi berkaitan

• Panduan Automasi REST API
• Gambaran Keseluruhan Automasi