ระบบอัตโนมัติดีพลิงก์

สร้างระบบอัตโนมัติ REST API โดยเปิด URL บน iPhone หรือ iPad ดีพลิงก์ไม่กำหนดปลายทางอื่น

รูปแบบ URL

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

url จำเป็น ใส่ name ที่สื่อความหมาย หากละไว้ ค่าเริ่มต้นคือ Automation ชื่อพารามิเตอร์ไม่แยกตัวพิมพ์ใหญ่-เล็ก เข้ารหัส URL ค่าพารามิเตอร์ที่มีช่องว่างหรืออักขระสงวน

เปิด URL บนอุปกรณ์ หรือใช้ เปิด URL ในคำสั่งลัด ตรวจระบบอัตโนมัติที่สร้างใน Health Auto Export ก่อนเปิดใช้

อ้างอิงพารามิเตอร์

ค่าบูลีนรับ true/false, 1/0 หรือ yes/no ตั้ง datatype ก่อนตัวเลือกเฉพาะข้อมูล และ format ก่อน aggregatedata เพื่อไม่ให้การเลือกภายหลังแทนที่การตั้งค่าก่อนหน้า

การตั้งค่าพื้นฐาน

พารามิเตอร์	ค่าหรือความหมาย	ค่าเริ่มต้น
url	URL ปลายทางที่เข้าถึงได้จากอุปกรณ์	จำเป็น
name	ชื่อระบบอัตโนมัติที่ไม่ว่าง	Automation
enabled	เปิดใช้การรันอัตโนมัติ	false
datatype	ประเภทข้อมูลด้านล่าง	healthMetrics
format	json, csv, markdown หรือ md	json
exportversion	v1, v2, 1 หรือ 2	v2
period	none, lastsync, today, yesterday, previous7days	none
requesttimeout	จำนวนวินาทีจำนวนเต็ม 60–86400	60
headers	คู่คีย์/ค่าคั่นด้วยจุลภาค	ไม่มี
batchrequests	บูลีน; เฉพาะ JSON	false

ประเภทข้อมูลที่ถูกต้องคือ healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking และ medications สถานะจิตใจต้องใช้ iOS 18 ขึ้นไป การส่งออกยาต้องใช้ iOS 26 ขึ้นไป

ความหมายช่วงวันที่ดูที่ ช่วงวันที่ ดีพลิงก์ทั้งหมดสร้างระบบอัตโนมัติ REST API ไม่มีพารามิเตอร์ exportDestination

เมตริกสุขภาพ

พารามิเตอร์	ค่าหรือความหมาย	ค่าเริ่มต้น
metrics	ชื่อเมตริกที่ตรงกันคั่นด้วยจุลภาค เช่น Step Count,Heart Rate	เมตริกทั้งหมดที่มี
aggregatedata	บูลีน; ใช้ false สำหรับค่าเดี่ยวเมื่อรองรับ	true
interval	none, minutes, hours, days, weeks, months, years	none
aggregatesleep	บูลีนควบคุมการสรุปการนอน	true

metrics, aggregatedata และ interval ใช้กับเมตริกสุขภาพ การเลือก CSV เปิดการสรุป ใช้ JSON สำหรับค่าเดี่ยว ระบุการสรุปที่ต้องการอย่างชัดเจนเมื่อสร้างลิงก์

การออกกำลังกาย

พารามิเตอร์	ค่าหรือความหมาย	ค่าเริ่มต้นเมื่อ datatype=workouts
includeroutes	บูลีน	true
includeworkoutmetadata	บูลีน	true
workoutsmetadatainterval	minutes หรือ seconds; เวอร์ชัน 2	minutes
workouttypes	ตัวระบุประเภทการออกกำลังกายของ Apple แบบไม่ติดเครื่องหมาย คั่นด้วยจุลภาค	ทุกประเภท

อย่าใส่ตัวเลือกการรวมเมตริกสุขภาพในลิงก์การออกกำลังกาย

จังหวะและการแจ้งเตือน

พารามิเตอร์	ค่าหรือความหมาย	ค่าเริ่มต้น
syncinterval	minutes, hours, days, weeks	minutes
syncquantity	จำนวนเต็มบวกของช่วง	5
notifyonupdate	บูลีน; แจ้งหลังเตรียมข้อมูล	true
notifywhenrun	บูลีน; แจ้งหลังการกระทำปลายทางสำเร็จ	true

จังหวะยังอยู่ภายใต้ ขีดจำกัดพื้นหลังและข้อมูลสุขภาพ ไม่ใช่ตารางที่แน่นอน

การยืนยันตัวตนและการเข้ารหัส

ค่า headers ประกอบด้วยคีย์และค่าสลับกัน:

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

แต่ละคีย์ต้องมีค่า จุลภาคคั่นคู่ ดังนั้นหลีกเลี่ยงค่าส่วนหัวที่มีจุลภาคในรูปแบบลิงก์นี้ เข้ารหัสช่องว่างเป็น %20 เครื่องหมายบวกเป็น %2B และแอมเพอร์แซนด์เป็น %26 เข้ารหัส URL ปลายทางทั้งหมดเมื่อมีพารามิเตอร์คิวรีของตัวเอง

ตัวอย่าง

เมตริกที่เลือก สรุปรายชั่วโมง

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

การออกกำลังกายพร้อมเส้นทาง

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

ทั้งสองตัวอย่างปล่อยการรันอัตโนมัติปิดไว้จนกว่าคุณจะตรวจและเปิดใช้ระบบอัตโนมัติ

การแก้ปัญหา

• ข้อผิดพลาด URL หรือพารามิเตอร์: เริ่มจาก URL ขั้นต่ำ ตรวจการสะกดและการเข้ารหัส แล้วเพิ่มตัวเลือกทีละรายการ
• เมตริกไม่ถูกต้อง: ใช้ชื่อเมตริกที่ตรงกัน รวมช่องว่างและการใช้ตัวพิมพ์ใหญ่
• ข้อผิดพลาดการรวม: ใช้ตัวเลือกเมตริกสุขภาพเฉพาะกับ datatype=healthMetrics
• ข้อผิดพลาดการตั้งค่าการออกกำลังกาย: ใช้ตัวเลือกการออกกำลังกายกับ datatype=workouts การจัดกลุ่มวินาทีต้องใช้เวอร์ชัน 2
• ข้อผิดพลาดการแบตช์: ตั้ง format=json หรือปิด batchrequests
• จังหวะ/หมดเวลาไม่ถูกต้อง: ใช้ช่วงที่รองรับ จำนวนบวก และหมดเวลาตั้งแต่ 60 ถึง 86400 วินาที
• URL ยาวเกินไป: ลดรายการเมตริก/ส่วนหัว หรือตั้งค่าที่เหลือในแอป

หลังสร้าง ใช้ REST API — ส่งออกข้อมูลย้อนหลังหรือที่พลาด เพื่ออัปโหลดช่วงที่เลือกหรือตรวจการตั้งค่า

เอกสารที่เกี่ยวข้อง

• คู่มือระบบอัตโนมัติ REST API
• ภาพรวมระบบอัตโนมัติ