Segerakkan data Apple Health ke REST API

Hantar eksport kesihatan ke titik akhir yang menerima permintaan HTTP POST.

Penting — had automasi: Peranti anda mesti tidak dikunci untuk membaca data kesihatan, dan iOS tidak menjamin jalanan latar belakang pada kekerapan yang anda pilih. Semak Had Automasi sebelum bergantung pada eksport automatik.

Membuka automasi

Buka Eksport → Automatik pada iPhone, atau Automasi dalam bar sisi iPad. Pilih Automasi Baharu, atau buka automasi sedia ada untuk mengeditnya.

Nama, status, dan pemberitahuan

Masukkan nama yang mengenal pasti automasi ini. Didayakan membenarkan jalanan automatik; biarkan dimatikan sehingga anda bersedia.

Pilih sebarang pemberitahuan jalanan yang anda mahu:

• Beritahu pada Kemas Kini Cache melaporkan bahawa data eksport telah disediakan.
• Beritahu Apabila Berjalan melaporkan muat naik yang berjaya ke titik akhir anda.

Benarkan pemberitahuan apabila digesa. Pemberitahuan ini melaporkan aktiviti; ia tidak menjadualkan jalanan.

Sediakan titik akhir

1. Pilih REST API sebagai Jenis Automasi.
2. Masukkan URL yang boleh dicapai dari iPhone atau iPad anda, seperti https://api.example.com/health-data.
3. Tambah sebarang pengesahan yang diperlukan di bawah HTTP Headers. Contohnya, gunakan Authorization sebagai kunci dan Bearer YOUR_TOKEN sebagai nilainya.
4. Pilih Request Timeout yang sesuai untuk titik akhir anda.

Setiap pengepala memerlukan kedua-dua kunci dan nilai. Untuk pelayan pada peranti lain, gunakan alamat rangkaiannya yang boleh dicapai dan bukannya localhost.

Tetapan Jenis Data

Pilih satu Jenis Data untuk automasi ini: Metrik Kesihatan, Senaman, Simptom, ECG, Pemberitahuan Kadar Jantung, Keadaan Minda, Penjejakan Kitaran, atau Ubat. Keadaan Minda memerlukan iOS 18 atau lebih baharu; Ubat memerlukan iOS 26 atau lebih baharu dan akses ubat berasingan.

Metrik kesihatan

Pilih Metrik Kesihatan, kemudian buka Pilih Metrik Kesihatan dan pilih ukuran yang anda perlukan.

Untuk mengehadkan bacaan kepada aplikasi atau peranti tertentu, buka Sumber Pilihan, pilih metrik, dan pilih sumbernya. Semua membenarkan setiap sumber yang belum dikecualikan. Gunakan Sumber Dikecualikan untuk mengabaikan sumber merentas metrik kesihatan automasi ini. Pengecualian mengatasi; sumber yang tidak dipilih tidak digantikan apabila sumber pilihan tiada data. Pilih Simpan untuk menggunakan pilihan sumber atau Batal untuk membuangnya.

Senaman

Pilih Senaman untuk mengeksport rekod senaman. Sertakan Data Laluan menambah titik laluan yang tersedia kepada data senaman JSON. Ia tidak mencipta muat naik GPX berasingan.

Untuk Versi 2, hidupkan Sertakan Metrik Senaman untuk menambah bacaan seperti kadar jantung, tenaga aktif, dan langkah. Pilih Minit atau Saat untuk Pengumpulan Masa metrik senaman; saat menghasilkan lebih banyak butiran dan eksport yang lebih besar. Versi 1 sentiasa menyertakan metrik senaman.

Tetapan Eksport

Format Eksport

• JSON memelihara data berstruktur untuk integrasi dan analisis.
• CSV mencipta fail jadual untuk hamparan.
• Markdown mencipta tajuk dan jadual yang mudah dibaca untuk nota dan arkib.

Versi Eksport

Pilih Versi 2 untuk struktur data semasa. Gunakan Versi 1 apabila aliran kerja sedia ada bergantung pada format yang lebih lama.

Julat Tarikh

Pemilihan	Data disertakan
Lalai	Hari sebelumnya dan hari ini hingga masa jalanan
Sejak Penyegerakan Terakhir	Sejak segerak sebelumnya hingga masa jalanan
Hari Ini	Hari ini hingga masa jalanan
Semalam	Hari penuh sebelumnya
7 Hari Sebelumnya	Tujuh hari penuh sebelumnya

Ringkaskan Data dan Pengumpulan Masa

Untuk JSON + Metrik Kesihatan, hidupkan Ringkaskan Data untuk menggabungkan bacaan ke dalam kumpulan masa, atau matikan untuk bacaan individu di mana tersedia. Ringkasan bergantung pada metrik—contohnya, langkah dijumlahkan dan bacaan berat dipuratakan. Eksport metrik kesihatan CSV menggunakan data yang diringkaskan.

Apabila Pengumpulan Masa tersedia, pilih berapa banyak butiran untuk dikekalkan. Kumpulan setiap jam atau harian menghasilkan lebih sedikit baris daripada kumpulan minit atau saat. Pilihan yang tersedia bergantung pada julat tarikh dan format. Pengumpulan masa senaman dikonfigurasikan secara berasingan di bawah Senaman.

Permintaan kelompok dan muatan besar

Untuk REST API + JSON, hidupkan Permintaan Kelompok untuk menghantar data merentas berbilang permintaan. Gunakan ini apabila titik akhir anda menolak badan besar atau permintaan besar tamat masa. Perkhidmatan penerima mesti mengendalikan setiap permintaan secara berasingan.

Pengelompokan tidak tersedia untuk CSV dan Markdown. Ia mengurangkan saiz permintaan individu tetapi tidak mengurangkan jumlah data kesihatan yang perlu dibaca peranti. Lihat Prestasi jika penyediaan perlahan.

Jadualkan Peringatan

Jika anda mahu gesaan untuk membuka kunci dan membuka aplikasi, hidupkan Dayakan Peringatan. Pilih Setiap jam, Setiap Hari, atau Hari Dipilih, kemudian tetapkan minit, masa, dan hari yang berkenaan. Benarkan akses pemberitahuan apabila digesa; jika akses ditolak, gunakan Buka Tetapan Pemberitahuan.

Peringatan tidak menjalankan automasi atau mengesahkan segerak yang berjaya. Ketuknya untuk membuka automasi, atau gunakan Buka & Segerak pada pemberitahuan untuk meminta jalanan. Automasi mesti didayakan; peringatan mungkin masih muncul selepas jalanan latar belakang berjaya. Perubahan peringatan terpakai apabila anda menyimpan.

Kekerapan Segerak dan simpan

Pilih nombor dan Minit, Jam, Hari, atau Minggu di bawah Kekerapan Segerak—contohnya, setiap 15 minit. Ini ialah rentak latar belakang yang diingini, bukan jadual yang dijamin.

Peranti anda mesti tidak dikunci apabila data kesihatan dibaca. Dayakan Muat Semula Aplikasi Latar Belakang untuk Health Auto Export dan matikan Mod Kuasa Rendah untuk jalanan automatik. iOS masih boleh melengahkan jalanan apabila peranti tidak aktif atau sumber sistem terhad.

Hidupkan Didayakan apabila anda bersedia untuk jalanan automatik, kemudian pilih Kemas Kini untuk menyimpan automasi. Anda boleh memuat naik julat tarikh yang dipilih serta-merta menggunakan langkah di bawah.

Pengepala permintaan

Aplikasi menetapkan Content-Type untuk format yang dipilih dan termasuk:

Pengepala	Makna
automation-name	Nama automasi
automation-id	Pengecam automasi
automation-aggregation	Pengumpulan masa yang dipilih
automation-period	Julat tarikh yang dipilih
session-id	Pengecam permintaan

Mengeksport data sejarah atau terlepas

Gunakan Muat Naik Manual apabila anda mula-mula menyediakan automasi untuk mengeksport data sejarah, atau kemudian untuk merangkumi tarikh yang terlepas oleh segerak automatik. Anda juga boleh menggunakannya untuk menyemak persediaan.

1. Buka automasi dan pilih Muat Naik Manual di bawah Eksport Data Sedia Ada.
2. Tetapkan tarikh Mula dan Tamat, kemudian pilih Mulakan Eksport.
3. Semak permintaan yang diterima titik akhir anda, pengepala, dan badan.

Penyelesaian masalah

• Tiada permintaan diterima: Semak URL, capaian rangkaian, dan log pelayan.
• Ralat pengesahan: Semak kunci pengepala, token, dan kebenaran titik akhir.
• Muatan ditolak atau tamat masa: Semak had saiz pelayan, gunakan pengelompokan untuk JSON, atau kurangkan saiz eksport.

Buka automasi dan pilih Lihat Log Aktiviti untuk menyemak jalanan. Amaran menandakan isu berpotensi seperti pengambilan data yang perlahan; ralat mengenal pasti langkah yang gagal. Untuk bantuan melaporkan isu, lihat Mendapatkan Bantuan.