Tự động hóa Deep Link

Tạo tự động hóa REST API bằng cách mở URL trên iPhone hoặc iPad. Deep link không cấu hình các đích khác.

Định dạng URL

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

url là bắt buộc. Cung cấp name mô tả; nếu bỏ qua, mặc định là Automation. Tên tham số không phân biệt hoa thường. Mã hóa URL các giá trị tham số chứa khoảng trắng hoặc ký tự dành riêng.

Mở URL trên thiết bị, hoặc dùng Open URLs trong Shortcuts. Xem lại tự động hóa đã tạo trong Health Auto Export trước khi bật.

Tham chiếu tham số

Boolean chấp nhận true/false, 1/0, hoặc yes/no. Đặt datatype trước các tùy chọn riêng theo dữ liệu, và format trước aggregatedata, để lựa chọn sau không thay thế cài đặt trước.

Cài đặt cơ bản

Tham số	Giá trị hoặc ý nghĩa	Mặc định
url	URL điểm cuối truy cập được từ thiết bị	Bắt buộc
name	Tên tự động hóa không rỗng	Automation
enabled	Bật chạy tự động	false
datatype	Loại dữ liệu liệt kê bên dưới	healthMetrics
format	json, csv, markdown, hoặc md	json
exportversion	v1, v2, 1, hoặc 2	v2
period	none, lastsync, today, yesterday, previous7days	none
requesttimeout	Số nguyên giây, 60–86400	60
headers	Các cặp khóa/giá trị phân tách bằng dấu phẩy	Không có
batchrequests	Boolean; chỉ JSON	false

Các loại dữ liệu hợp lệ là healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking, và medications. Trạng thái tinh thần cần iOS 18 trở lên; xuất thuốc cần iOS 26 trở lên.

Về ý nghĩa phạm vi ngày, xem Phạm vi ngày. Mọi deep link tạo tự động hóa REST API; không có tham số exportDestination.

Chỉ số sức khỏe

Tham số	Giá trị hoặc ý nghĩa	Mặc định
metrics	Tên chỉ số chính xác phân tách bằng dấu phẩy, ví dụ Step Count,Heart Rate	Tất cả chỉ số khả dụng
aggregatedata	Boolean; dùng false cho từng số đo khi được hỗ trợ	true
interval	none, minutes, hours, days, weeks, months, years	none
aggregatesleep	Boolean điều khiển tóm tắt giấc ngủ	true

metrics, aggregatedata, và interval áp dụng cho chỉ số sức khỏe. Chọn CSV bật tóm tắt; dùng JSON cho từng số đo. Chỉ định rõ tóm tắt mong muốn khi tạo liên kết.

Buổi tập

Tham số	Giá trị hoặc ý nghĩa	Mặc định khi datatype=workouts
includeroutes	Boolean	true
includeworkoutmetadata	Boolean	true
workoutsmetadatainterval	minutes hoặc seconds; Phiên bản 2	minutes
workouttypes	Mã định danh kiểu buổi tập Apple không dấu, phân tách bằng dấu phẩy	Tất cả loại

Không đưa tùy chọn tổng hợp chỉ số sức khỏe vào liên kết buổi tập.

Nhịp và thông báo

Tham số	Giá trị hoặc ý nghĩa	Mặc định
syncinterval	minutes, hours, days, weeks	minutes
syncquantity	Số nguyên dương số khoảng	5
notifyonupdate	Boolean; thông báo sau chuẩn bị dữ liệu	true
notifywhenrun	Boolean; thông báo sau hành động đích thành công	true

Nhịp vẫn chịu giới hạn nền và dữ liệu sức khỏe; không phải lịch chính xác.

Xác thực và mã hóa

Giá trị headers gồm các khóa và giá trị xen kẽ:

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

Mỗi khóa cần một giá trị. Dấu phẩy tách các cặp, nên tránh giá trị tiêu đề chứa dấu phẩy trong định dạng liên kết này. Mã hóa khoảng trắng thành %20, dấu cộng thành %2B, và dấu & thành %26. Mã hóa toàn bộ URL điểm cuối khi nó có tham số truy vấn riêng.

Ví dụ

Chỉ số đã chọn, tóm tắt theo giờ

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

Buổi tập kèm tuyến đường

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

Cả hai ví dụ đều để chạy tự động tắt cho đến khi bạn xem lại và bật tự động hóa.

Khắc phục sự cố

• Lỗi URL hoặc tham số: Bắt đầu với URL tối thiểu, kiểm tra chính tả và mã hóa, rồi thêm tùy chọn từng cái.
• Chỉ số không hợp lệ: Dùng tên chỉ số chính xác, gồm khoảng trắng và chữ hoa.
• Lỗi tổng hợp: Chỉ dùng tùy chọn chỉ số sức khỏe với datatype=healthMetrics.
• Lỗi cài đặt buổi tập: Dùng tùy chọn buổi tập với datatype=workouts; nhóm giây cần Phiên bản 2.
• Lỗi theo lô: Đặt format=json hoặc tắt batchrequests.
• Nhịp/timeout không hợp lệ: Dùng khoảng được hỗ trợ, số lượng dương, và timeout từ 60 đến 86400 giây.
• URL quá dài: Giảm danh sách chỉ số/tiêu đề hoặc cấu hình phần còn lại trong ứng dụng.

Sau khi tạo, dùng REST API — Xuất dữ liệu lịch sử hoặc bị bỏ lỡ để tải lên phạm vi đã chọn hoặc kiểm tra thiết lập.

Tài liệu liên quan

• Hướng dẫn tự động hóa REST API
• Tổng quan tự động hóa