ซิงค์ข้อมูล Apple Health ไปยัง REST API

ส่งไฟล์ส่งออกสุขภาพไปยังปลายทางที่รับคำขอ HTTP POST

สำคัญ — ข้อจำกัดระบบอัตโนมัติ: อุปกรณ์ต้องปลดล็อกเพื่ออ่านข้อมูลสุขภาพ และ iOS ไม่รับประกันการรันพื้นหลังตามความถี่ที่เลือก ตรวจ ข้อจำกัดระบบอัตโนมัติ ก่อนพึ่งพาการส่งออกอัตโนมัติ

เปิดระบบอัตโนมัติ

เปิด ส่งออก → อัตโนมัติ บน iPhone หรือ ระบบอัตโนมัติ ในแถบด้านข้าง iPad เลือก ระบบอัตโนมัติใหม่ หรือเปิดระบบอัตโนมัติที่มีอยู่เพื่อแก้ไข

ชื่อ สถานะ และการแจ้งเตือน

ใส่ชื่อที่ระบุระบบอัตโนมัตินี้ เปิดใช้ อนุญาตการรันอัตโนมัติ ปล่อยปิดไว้จนกว่าจะพร้อม

เลือกการแจ้งเตือนเมื่อรันที่ต้องการ:

• แจ้งเมื่ออัปเดตแคช รายงานว่าข้อมูลส่งออกถูกเตรียมแล้ว
• แจ้งเมื่อรัน รายงานการอัปโหลดไปยังปลายทางของคุณสำเร็จ

อนุญาตการแจ้งเตือนเมื่อถูกถาม การแจ้งเตือนเหล่านี้รายงานกิจกรรม ไม่จัดตารางการรัน

ตั้งค่าปลายทาง

1. เลือก REST API เป็น ประเภทระบบอัตโนมัติ
2. ใส่ URL ที่เข้าถึงได้จาก iPhone หรือ iPad เช่น https://api.example.com/health-data
3. เพิ่มการยืนยันตัวตนที่ต้องการภายใต้ ส่วนหัว HTTP ตัวอย่างเช่น ใช้ Authorization เป็นคีย์ และ Bearer YOUR_TOKEN เป็นค่า
4. เลือก หมดเวลาคำขอ ที่เหมาะสมกับปลายทางของคุณ

แต่ละส่วนหัวต้องมีทั้งคีย์และค่า สำหรับเซิร์ฟเวอร์บนอุปกรณ์อื่น ใช้ที่อยู่เครือข่ายที่เข้าถึงได้แทน localhost

การตั้งค่าประเภทข้อมูล

เลือก ประเภทข้อมูล หนึ่งรายการสำหรับระบบอัตโนมัตินี้: เมตริกสุขภาพ การออกกำลังกาย อาการ ECG การแจ้งเตือนอัตราหัวใจ สถานะจิตใจ การติดตามรอบ หรือยา สถานะจิตใจต้องใช้ iOS 18 ขึ้นไป ยาต้องใช้ iOS 26 ขึ้นไปและการเข้าถึงยาแยกต่างหาก

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

เลือก เมตริกสุขภาพ แล้วเปิด เลือกเมตริกสุขภาพ และเลือกการวัดที่ต้องการ

หากต้องการจำกัดค่าไปยังแอปหรืออุปกรณ์บางอย่าง เปิด แหล่งที่ต้องการ เลือกเมตริก แล้วเลือกแหล่งของมัน ทั้งหมด อนุญาตทุกแหล่งที่ไม่ได้ถูกยกเว้น ใช้ แหล่งที่ยกเว้น เพื่อละเว้นแหล่งในเมตริกสุขภาพของระบบอัตโนมัตินี้ การยกเว้นมีลำดับความสำคัญสูงกว่า ไม่มีการแทนที่แหล่งที่ไม่ได้เลือกเมื่อแหล่งที่ต้องการไม่มีข้อมูล เลือก บันทึก เพื่อใช้ตัวเลือกแหล่ง หรือ ยกเลิก เพื่อทิ้ง

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

เลือก การออกกำลังกาย เพื่อส่งออกบันทึกการออกกำลังกาย รวมข้อมูลเส้นทาง เพิ่มจุดเส้นทางที่มีไปยังข้อมูลการออกกำลังกาย JSON ไม่สร้างการอัปโหลด GPX แยก

สำหรับ เวอร์ชัน 2 เปิด รวมเมตริกการออกกำลังกาย เพื่อเพิ่มค่า เช่น อัตราหัวใจ พลังงานที่ใช้งาน และก้าว เลือก นาที หรือ วินาที สำหรับ การจัดกลุ่มเวลา ของเมตริกการออกกำลังกาย วินาทีให้รายละเอียดมากกว่าและไฟล์ใหญ่กว่า เวอร์ชัน 1 รวมเมตริกการออกกำลังกายเสมอ

การตั้งค่าการส่งออก

รูปแบบการส่งออก

• JSON รักษาข้อมูลที่มีโครงสร้างสำหรับการเชื่อมต่อและการวิเคราะห์
• CSV สร้างไฟล์ตารางสำหรับสเปรดชีต
• Markdown สร้างหัวข้อและตารางที่อ่านได้สำหรับบันทึกและคลัง

เวอร์ชันการส่งออก

เลือก เวอร์ชัน 2 สำหรับโครงสร้างข้อมูลปัจจุบัน ใช้ เวอร์ชัน 1 เมื่อเวิร์กโฟลว์ที่มีอยู่พึ่งพารูปแบบเก่า

ช่วงวันที่

การเลือก	ข้อมูลที่รวม
ค่าเริ่มต้น	วันก่อนหน้าและวันนี้จนถึงเวลาที่รัน
ตั้งแต่ซิงค์ล่าสุด	ตั้งแต่ซิงค์ก่อนหน้าจนถึงเวลาที่รัน
วันนี้	วันนี้จนถึงเวลาที่รัน
เมื่อวาน	วันก่อนหน้าทั้งวัน
7 วันที่ผ่านมา	เจ็ดวันเต็มก่อนหน้า

สรุปข้อมูลและการจัดกลุ่มเวลา

สำหรับ JSON + เมตริกสุขภาพ เปิด สรุปข้อมูล เพื่อรวมค่าเป็นกลุ่มเวลา หรือปิดสำหรับค่าเดี่ยวเมื่อมี การสรุปขึ้นกับเมตริก — เช่น ก้าวถูกรวม และค่าน้ำหนักถูกเฉลี่ย การส่งออกเมตริกสุขภาพแบบ CSV ใช้ข้อมูลสรุป

เมื่อมี การจัดกลุ่มเวลา เลือกว่าจะเก็บรายละเอียดมากเพียงใด กลุ่มรายชั่วโมงหรือรายวันสร้างแถวน้อยกว่ากลุ่มนาทีหรือวินาที ตัวเลือกที่มีขึ้นกับช่วงวันที่และรูปแบบ การจัดกลุ่มเวลาของการออกกำลังกายตั้งแยกภายใต้การออกกำลังกาย

คำขอแบบแบตช์และเพย์โหลดขนาดใหญ่

สำหรับ REST API + JSON เปิด คำขอแบบแบตช์ เพื่อส่งข้อมูลหลายคำขอ ใช้เมื่อปลายทางปฏิเสธร่างใหญ่หรือคำขอใหญ่หมดเวลา บริการที่รับต้องจัดการแต่ละคำขอแยกกัน

การแบตช์ใช้ไม่ได้กับ CSV และ Markdown ลดขนาดคำขอแต่ละรายการ แต่ไม่ลดปริมาณข้อมูลสุขภาพที่อุปกรณ์ต้องอ่าน หากการเตรียมช้า ดู ประสิทธิภาพ

จัดตารางการเตือน

หากต้องการการเตือนให้ปลดล็อกและเปิดแอป เปิด เปิดใช้การเตือน เลือก ทุกชั่วโมง ทุกวัน หรือ วันที่เลือก แล้วตั้งนาที เวลา และวันตามที่ใช้ได้ อนุญาตการเข้าถึงการแจ้งเตือนเมื่อถูกถาม หากถูกปฏิเสธ ใช้ เปิดการตั้งค่าการแจ้งเตือน

การเตือนไม่รันระบบอัตโนมัติและไม่ยืนยันการซิงค์ที่สำเร็จ แตะเพื่อเปิดระบบอัตโนมัติ หรือใช้ เปิดและซิงค์ บนการแจ้งเตือนเพื่อขอการรัน ระบบอัตโนมัติต้องเปิดใช้ การเตือนอาจยังปรากฏหลังการรันพื้นหลังที่สำเร็จ การเปลี่ยนแปลงการเตือนมีผลเมื่อบันทึก

ความถี่การซิงค์และการบันทึก

เลือกตัวเลขและ นาที ชั่วโมง วัน หรือ สัปดาห์ ภายใต้ ความถี่การซิงค์ — เช่น ทุก 15 นาที นี่คือจังหวะพื้นหลังที่ต้องการ ไม่ใช่ตารางที่รับประกัน

อุปกรณ์ต้องปลดล็อกเมื่ออ่านข้อมูลสุขภาพ เปิดการรีเฟรชแอปพื้นหลังสำหรับ Health Auto Export และปิดโหมดพลังงานต่ำสำหรับการรันอัตโนมัติ iOS ยังอาจหน่วงการรันเมื่ออุปกรณ์ไม่ได้ใช้งานหรือทรัพยากรระบบจำกัด

เปิด เปิดใช้ เมื่อพร้อมสำหรับการรันอัตโนมัติ แล้วเลือก อัปเดต เพื่อบันทึกระบบอัตโนมัติ คุณสามารถอัปโหลดช่วงวันที่ที่เลือกได้ทันทีด้วยขั้นตอนด้านล่าง

ส่วนหัวคำขอ

แอปตั้ง Content-Type สำหรับรูปแบบที่เลือก และรวม:

ส่วนหัว	ความหมาย
automation-name	ชื่อระบบอัตโนมัติ
automation-id	ตัวระบุระบบอัตโนมัติ
automation-aggregation	การจัดกลุ่มเวลาที่เลือก
automation-period	ช่วงวันที่ที่เลือก
session-id	ตัวระบุคำขอ

ส่งออกข้อมูลย้อนหลังหรือที่พลาด

ใช้ อัปโหลดด้วยตนเอง เมื่อตั้งค่าระบบอัตโนมัติครั้งแรกเพื่อส่งออกข้อมูลย้อนหลัง หรือภายหลังเพื่อครอบคลุมวันที่ที่การซิงค์อัตโนมัติพลาด คุณยังสามารถใช้เพื่อตรวจสอบการตั้งค่า

1. เปิดระบบอัตโนมัติแล้วเลือก อัปโหลดด้วยตนเอง ภายใต้ ส่งออกข้อมูลที่มีอยู่
2. ตั้งวันที่ เริ่ม และ สิ้นสุด แล้วเลือก เริ่มส่งออก
3. ตรวจคำขอ ส่วนหัว และร่างที่ปลายทางได้รับ

การแก้ปัญหา

• ไม่ได้รับคำขอ: ตรวจ URL ความสามารถในการเข้าถึงเครือข่าย และบันทึกเซิร์ฟเวอร์
• ข้อผิดพลาดการยืนยันตัวตน: ตรวจคีย์ส่วนหัว โทเค็น และสิทธิ์ปลายทาง
• เพย์โหลดถูกปฏิเสธหรือหมดเวลา: ตรวจขีดจำกัดขนาดของเซิร์ฟเวอร์ ใช้การแบตช์สำหรับ JSON หรือลดขนาดการส่งออก

เปิดระบบอัตโนมัติแล้วเลือก ดูบันทึกกิจกรรม เพื่อตรวจการรัน คำเตือน ระบุปัญหาที่อาจเกิด เช่น การดึงข้อมูลช้า ข้อผิดพลาด ระบุขั้นตอนที่ล้มเหลว สำหรับความช่วยเหลือในการรายงานปัญหา ดู ขอความช่วยเหลือ