Sinkronkan data Apple Health ke REST API

Kirim ekspor kesehatan ke titik akhir yang menerima permintaan HTTP POST.

Penting — batasan otomatisasi: Perangkat Anda harus tidak terkunci untuk membaca data kesehatan, dan iOS tidak menjamin proses latar belakang pada frekuensi yang Anda pilih. Tinjau Batasan Otomatisasi sebelum mengandalkan ekspor otomatis.

Membuka otomatisasi

Buka Ekspor → Otomatis di iPhone, atau Otomatisasi di bilah sisi iPad. Pilih Otomatisasi Baru, atau buka otomatisasi yang sudah ada untuk mengeditnya.

Nama, status, dan notifikasi

Masukkan nama yang mengidentifikasi otomatisasi ini. Diaktifkan memungkinkan proses otomatis; biarkan nonaktif sampai Anda siap.

Pilih notifikasi proses yang Anda inginkan:

• Beritahu saat Pembaruan Cache melaporkan bahwa data ekspor telah disiapkan.
• Beritahu saat Proses melaporkan unggahan berhasil ke titik akhir Anda.

Izinkan notifikasi saat diminta. Notifikasi ini melaporkan aktivitas; notifikasi tidak menjadwalkan proses.

Menyiapkan titik akhir

1. Pilih REST API sebagai Jenis Otomatisasi.
2. Masukkan URL yang dapat dijangkau dari iPhone atau iPad Anda, misalnya https://api.example.com/health-data.
3. Tambahkan autentikasi yang diperlukan di bawah HTTP Headers. Misalnya, gunakan Authorization sebagai kunci dan Bearer YOUR_TOKEN sebagai nilainya.
4. Pilih Request Timeout yang sesuai untuk titik akhir Anda.

Setiap header memerlukan kunci dan nilai. Untuk server di perangkat lain, gunakan alamat jaringan yang dapat dijangkau daripada localhost.

Pengaturan Jenis Data

Pilih satu Jenis Data untuk otomatisasi ini: Metrik Kesehatan, Latihan, Gejala, ECG, Notifikasi Denyut Jantung, Keadaan Pikiran, Pelacakan Siklus, atau Obat. Keadaan Pikiran memerlukan iOS 18 atau lebih baru; Obat memerlukan iOS 26 atau lebih baru dan akses obat terpisah.

Metrik kesehatan

Pilih Metrik Kesehatan, lalu buka Pilih Metrik Kesehatan dan pilih pengukuran yang Anda butuhkan.

Untuk membatasi pembacaan ke aplikasi atau perangkat tertentu, buka Sumber yang Disukai, pilih metrik, dan pilih sumbernya. Semua mengizinkan setiap sumber yang belum dikecualikan. Gunakan Sumber yang Dikecualikan untuk mengabaikan sumber di semua metrik kesehatan otomatisasi ini. Pengecualian didahulukan; sumber yang tidak dipilih tidak digantikan saat sumber yang diutamakan tidak memiliki data. Pilih Simpan untuk menerapkan pilihan sumber atau Batal untuk membuangnya.

Latihan

Pilih Latihan untuk mengekspor catatan latihan. Sertakan Data Rute menambahkan titik rute yang tersedia ke data latihan JSON. Ini tidak membuat unggahan GPX terpisah.

Untuk Versi 2, aktifkan Sertakan Metrik Latihan untuk menambahkan pembacaan seperti denyut jantung, energi aktif, dan langkah. Pilih Menit atau Detik untuk Pengelompokan Waktu metrik latihan; detik menghasilkan lebih banyak detail dan ekspor yang lebih besar. Versi 1 selalu menyertakan metrik latihan.

Pengaturan Ekspor

Format Ekspor

• JSON mempertahankan data terstruktur untuk integrasi dan analisis.
• CSV membuat file tabel untuk lembar kerja.
• Markdown membuat judul dan tabel yang mudah dibaca untuk catatan dan arsip.

Versi Ekspor

Pilih Versi 2 untuk struktur data saat ini. Gunakan Versi 1 saat alur kerja yang ada bergantung pada format yang lebih lama.

Rentang Tanggal

Pilihan	Data yang disertakan
Bawaan	Hari sebelumnya dan hari ini hingga waktu proses
Sejak Sinkronisasi Terakhir	Sejak sinkronisasi sebelumnya hingga waktu proses
Hari Ini	Hari ini hingga waktu proses
Kemarin	Hari penuh sebelumnya
7 Hari Sebelumnya	Tujuh hari penuh sebelumnya

Ringkas Data dan Pengelompokan Waktu

Untuk JSON + Metrik Kesehatan, aktifkan Ringkas Data untuk menggabungkan pembacaan ke dalam kelompok waktu, atau matikan untuk pembacaan individual jika tersedia. Ringkasan bergantung pada metrik—misalnya, langkah dijumlahkan dan pembacaan berat dirata-ratakan. Ekspor metrik kesehatan CSV menggunakan data yang diringkas.

Saat Pengelompokan Waktu tersedia, pilih seberapa banyak detail yang disimpan. Kelompok per jam atau harian menghasilkan lebih sedikit baris daripada kelompok menit atau detik. Pilihan yang tersedia bergantung pada rentang tanggal dan format. Pengelompokan waktu latihan dikonfigurasi secara terpisah di bawah Latihan.

Permintaan batch dan muatan besar

Untuk REST API + JSON, aktifkan Permintaan Batch untuk mengirim data di beberapa permintaan. Gunakan ini saat titik akhir Anda menolak body besar atau permintaan besar mengalami timeout. Layanan penerima harus menangani setiap permintaan secara terpisah.

Batching tidak tersedia untuk CSV dan Markdown. Ini mengurangi ukuran permintaan individual tetapi tidak mengurangi jumlah data kesehatan yang perlu dibaca perangkat. Lihat Performa jika penyiapan lambat.

Jadwalkan Pengingat

Jika Anda ingin perintah untuk membuka kunci dan membuka aplikasi, aktifkan Aktifkan Pengingat. Pilih Setiap jam, Setiap hari, atau Hari yang dipilih, lalu atur menit, waktu, dan hari yang berlaku. Izinkan akses notifikasi saat diminta; jika akses ditolak, gunakan Buka Pengaturan Notifikasi.

Pengingat tidak menjalankan otomatisasi atau mengonfirmasi sinkronisasi yang berhasil. Ketuk untuk membuka otomatisasi, atau gunakan Buka & Sinkronkan pada notifikasi untuk meminta proses. Otomatisasi harus diaktifkan; pengingat tetap dapat muncul setelah proses latar belakang berhasil. Perubahan pengingat berlaku saat Anda menyimpan.

Frekuensi Sinkronisasi dan menyimpan

Pilih angka dan Menit, Jam, Hari, atau Minggu di bawah Frekuensi Sinkronisasi—misalnya, setiap 15 menit. Ini adalah ritme latar belakang yang diinginkan, bukan jadwal yang dijamin.

Perangkat Anda harus tidak terkunci saat data kesehatan dibaca. Aktifkan Penyegaran Aplikasi Latar Belakang untuk Health Auto Export dan matikan Mode Daya Rendah untuk proses otomatis. iOS tetap dapat menunda proses saat perangkat tidak aktif atau sumber daya sistem terbatas.

Aktifkan Diaktifkan saat Anda siap untuk proses otomatis, lalu pilih Perbarui untuk menyimpan otomatisasi. Anda dapat mengunggah rentang tanggal yang dipilih segera menggunakan langkah di bawah.

Header permintaan

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

Header	Arti
automation-name	Nama otomatisasi
automation-id	Pengenal otomatisasi
automation-aggregation	Pengelompokan waktu yang dipilih
automation-period	Rentang tanggal yang dipilih
session-id	Pengenal permintaan

Mengekspor data historis atau yang terlewat

Gunakan Unggah Manual saat pertama kali menyiapkan otomatisasi untuk mengekspor data historis, atau nanti untuk mencakup tanggal yang terlewat oleh sinkronisasi otomatis. Anda juga dapat menggunakannya untuk memeriksa penyiapan.

1. Buka otomatisasi dan pilih Unggah Manual di bawah Ekspor Data yang Ada.
2. Atur tanggal Mulai dan Akhir, lalu pilih Mulai Ekspor.
3. Periksa permintaan yang diterima titik akhir Anda, header, dan body.

Pemecahan masalah

• Tidak ada permintaan diterima: Periksa URL, jangkauan jaringan, dan log server.
• Kesalahan autentikasi: Periksa kunci header, token, dan izin titik akhir.
• Muatan ditolak atau timeout: Periksa batas ukuran server, gunakan batching untuk JSON, atau kurangi ukuran ekspor.

Buka otomatisasi dan pilih Lihat Log Aktivitas untuk meninjau proses. Peringatan menandai potensi masalah seperti pengambilan data yang lambat; kesalahan mengidentifikasi langkah yang gagal. Untuk bantuan melaporkan masalah, lihat Mendapatkan Bantuan.