Đồng bộ dữ liệu Apple Health với REST API

Gửi xuất sức khỏe tới điểm cuối chấp nhận yêu cầu HTTP POST.

Quan trọng — hạn chế tự động hóa: Thiết bị phải được mở khóa để đọc dữ liệu sức khỏe, và iOS không đảm bảo chạy nền theo tần suất bạn chọn. Xem Hạn chế tự động hóa trước khi dựa vào xuất tự động.

Mở tự động hóa

Mở Xuất → Tự động trên iPhone, hoặc Tự động hóa trong thanh bên iPad. Chọn Tự động hóa mới, hoặc mở tự động hóa hiện có để chỉnh sửa.

Tên, trạng thái và thông báo

Nhập tên nhận diện tự động hóa này. Đã bật cho phép chạy tự động; để tắt cho đến khi sẵn sàng.

Chọn mọi thông báo khi chạy bạn muốn:

• Thông báo khi cập nhật bộ nhớ đệm báo dữ liệu xuất đã được chuẩn bị.
• Thông báo khi chạy báo tải lên điểm cuối thành công.

Cho phép thông báo khi được nhắc. Các thông báo này báo hoạt động; chúng không lập lịch chạy.

Thiết lập điểm cuối

1. Chọn REST API làm Loại tự động hóa.
2. Nhập URL truy cập được từ iPhone hoặc iPad, ví dụ https://api.example.com/health-data.
3. Thêm mọi xác thực cần thiết dưới HTTP Headers. Ví dụ, dùng Authorization làm khóa và Bearer YOUR_TOKEN làm giá trị.
4. Chọn Request Timeout phù hợp với điểm cuối.

Mỗi tiêu đề cần cả khóa và giá trị. Đối với máy chủ trên thiết bị khác, dùng địa chỉ mạng truy cập được thay vì localhost.

Cài đặt loại dữ liệu

Chọn một Loại dữ liệu cho tự động hóa này: Chỉ số sức khỏe, Buổi tập, Triệu chứng, ECG, Thông báo nhịp tim, Trạng thái tinh thần, Theo dõi chu kỳ, hoặc Thuốc. Trạng thái tinh thần cần iOS 18 trở lên; Thuốc cần iOS 26 trở lên và quyền truy cập thuốc riêng.

Chỉ số sức khỏe

Chọn Chỉ số sức khỏe, rồi mở Chọn chỉ số sức khỏe và chọn các phép đo bạn cần.

Để giới hạn số đo ở ứng dụng hoặc thiết bị cụ thể, mở Nguồn ưu tiên, chọn chỉ số và chọn nguồn của nó. Tất cả cho phép mọi nguồn chưa bị loại trừ. Dùng Nguồn bị loại trừ để bỏ qua một nguồn trên mọi chỉ số sức khỏe của tự động hóa này. Loại trừ được ưu tiên; nguồn chưa chọn không được thay thế khi nguồn ưu tiên không có dữ liệu. Chọn Lưu để áp dụng lựa chọn nguồn hoặc Hủy để bỏ.

Buổi tập

Chọn Buổi tập để xuất bản ghi buổi tập. Bao gồm dữ liệu tuyến đường thêm các điểm tuyến đường khả dụng vào dữ liệu buổi tập JSON. Không tạo tải lên GPX riêng.

Đối với Phiên bản 2, bật Bao gồm chỉ số buổi tập để thêm các số đo như nhịp tim, năng lượng hoạt động và bước. Chọn Phút hoặc Giây cho Nhóm thời gian chỉ số buổi tập; giây tạo chi tiết hơn và xuất lớn hơn. Phiên bản 1 luôn bao gồm chỉ số buổi tập.

Cài đặt xuất

Định dạng xuất

• JSON giữ dữ liệu có cấu trúc cho tích hợp và phân tích.
• CSV tạo tệp dạng bảng cho bảng tính.
• Markdown tạo tiêu đề và bảng dễ đọc cho ghi chú và lưu trữ.

Phiên bản xuất

Chọn Phiên bản 2 cho cấu trúc dữ liệu hiện tại. Dùng Phiên bản 1 khi quy trình hiện có phụ thuộc định dạng cũ hơn.

Phạm vi ngày

Lựa chọn	Dữ liệu bao gồm
Mặc định	Ngày trước và hôm nay đến thời điểm chạy
Từ lần đồng bộ cuối	Từ lần đồng bộ trước đến thời điểm chạy
Hôm nay	Hôm nay đến thời điểm chạy
Hôm qua	Ngày đầy đủ trước đó
7 ngày trước	Bảy ngày đầy đủ trước đó

Tóm tắt dữ liệu và nhóm thời gian

Đối với JSON + Chỉ số sức khỏe, bật Tóm tắt dữ liệu để kết hợp số đo thành nhóm thời gian, hoặc tắt cho từng số đo khi khả dụng. Tóm tắt phụ thuộc chỉ số—ví dụ bước được cộng và số đo cân nặng được lấy trung bình. Xuất chỉ số sức khỏe CSV dùng dữ liệu đã tóm tắt.

Khi Nhóm thời gian khả dụng, chọn mức chi tiết cần giữ. Nhóm theo giờ hoặc ngày tạo ít hàng hơn nhóm phút hoặc giây. Lựa chọn khả dụng phụ thuộc phạm vi ngày và định dạng. Nhóm thời gian buổi tập được cấu hình riêng dưới Buổi tập.

Yêu cầu theo lô và payload lớn

Đối với REST API + JSON, bật Yêu cầu theo lô để gửi dữ liệu qua nhiều yêu cầu. Dùng khi điểm cuối từ chối thân lớn hoặc yêu cầu lớn hết thời gian chờ. Dịch vụ nhận phải xử lý từng yêu cầu riêng.

Theo lô không khả dụng cho CSV và Markdown. Nó giảm kích thước từng yêu cầu nhưng không giảm lượng dữ liệu sức khỏe thiết bị cần đọc. Xem Hiệu suất nếu chuẩn bị chậm.

Lịch nhắc

Nếu muốn được nhắc mở khóa và mở ứng dụng, bật Bật nhắc nhở. Chọn Hàng giờ, Mỗi ngày, hoặc Các ngày đã chọn, rồi đặt phút, giờ và ngày khi áp dụng. Cho phép quyền thông báo khi được nhắc; nếu bị từ chối, dùng Mở Cài đặt thông báo.

Nhắc không chạy tự động hóa và không xác nhận đồng bộ thành công. Chạm để mở tự động hóa, hoặc dùng Mở & Đồng bộ trên thông báo để yêu cầu chạy. Tự động hóa phải được bật; nhắc vẫn có thể xuất hiện sau lần chạy nền thành công. Thay đổi nhắc áp dụng khi bạn lưu.

Tần suất đồng bộ và lưu

Chọn một số và Phút, Giờ, Ngày, hoặc Tuần dưới Tần suất đồng bộ—ví dụ mỗi 15 phút. Đây là nhịp nền mong muốn, không phải lịch đảm bảo.

Thiết bị phải được mở khóa khi đọc dữ liệu sức khỏe. Bật Làm mới ứng dụng nền cho Health Auto Export và tắt Chế độ nguồn thấp cho các lần chạy tự động. iOS vẫn có thể trì hoãn chạy khi thiết bị không hoạt động hoặc tài nguyên hệ thống hạn chế.

Bật Đã bật khi sẵn sàng cho các lần chạy tự động, rồi chọn Cập nhật để lưu tự động hóa. Bạn có thể tải lên ngay phạm vi ngày đã chọn bằng các bước bên dưới.

Tiêu đề yêu cầu

Ứng dụng đặt Content-Type cho định dạng đã chọn và bao gồm:

Tiêu đề	Ý nghĩa
automation-name	Tên tự động hóa
automation-id	Định danh tự động hóa
automation-aggregation	Nhóm thời gian đã chọn
automation-period	Phạm vi ngày đã chọn
session-id	Định danh yêu cầu

Xuất dữ liệu lịch sử hoặc bị bỏ lỡ

Dùng Tải lên thủ công khi lần đầu thiết lập tự động hóa để xuất dữ liệu lịch sử, hoặc sau này để bù các ngày bị đồng bộ tự động bỏ lỡ. Bạn cũng có thể dùng để kiểm tra thiết lập.

1. Mở tự động hóa và chọn Tải lên thủ công dưới Xuất dữ liệu hiện có.
2. Đặt ngày Bắt đầu và Kết thúc, rồi chọn Bắt đầu xuất.
3. Kiểm tra yêu cầu đã nhận, tiêu đề và thân trên điểm cuối.

Khắc phục sự cố

• Không nhận được yêu cầu: Kiểm tra URL, khả năng truy cập mạng và nhật ký máy chủ.
• Lỗi xác thực: Kiểm tra khóa tiêu đề, token và quyền điểm cuối.
• Payload bị từ chối hoặc hết thời gian chờ: Kiểm tra giới hạn kích thước máy chủ, dùng theo lô cho JSON, hoặc giảm kích thước xuất.

Mở tự động hóa và chọn Xem nhật ký hoạt động để xem lại lần chạy. Cảnh báo đánh dấu vấn đề tiềm ẩn như truy xuất dữ liệu chậm; lỗi xác định các bước thất bại. Để được trợ giúp báo cáo vấn đề, xem Nhận trợ giúp.