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

ระบบอัตโนมัติ REST API ช่วยให้คุณส่งออกข้อมูลสุขภาพไปยังเว็บเซอร์วิสที่รับ HTTP POST โดยอัตโนมัติ เหมาะสำหรับเชื่อมต่อแบ็กเนดที่กำหนดเอง API ของบุคคลที่สาม หรือเว็บฮุก

ภาพรวม

ระบบอัตโนมัติ REST API ส่งข้อมูลสุขภาพไปยัง URL ที่กำหนดด้วยคำขอ HTTP POST สามารถส่งเป็น JSON หรือ CSV พร้อมกำหนดส่วนหัวสำหรับการยืนยันตัวตนและเมทาดาทา

กรณีใช้งาน:

• เชื่อมต่อกับบริการแบ็กเนดที่กำหนดเอง
• ส่งข้อมูลไปยังเว็บฮุก
• ซิงก์กับ API ของบุคคลที่สาม
• สร้างแดชบอร์ดหรือแพลตฟอร์มวิเคราะห์

คุณสมบัติหลัก:

• รองรับทั้ง JSON และ CSV
• กำหนด HTTP headers เองสำหรับการยืนยันตัวตน
• ตั้งค่าหมดเวลาคำขอได้
• ส่งออกข้อมูลย้อนหลังด้วยตนเองได้

ข้อจำกัด

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

• การประมวลผลในพื้นหลัง: iOS จำกัดการประมวลผลในพื้นหลังเพื่อรักษาแบตเตอรี่ ระบบอัตโนมัติอาศัยการรีเฟรชแอปในพื้นหลังและอาจไม่รันทันทีหาก:

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

ข้อกำหนดเบื้องต้น

• URL ปลายทางที่ถูกต้องและรับ HTTP POST
• ข้อมูลประจำตัวสำหรับยืนยันตัวตน (หากปลายทางต้องการ)
• การเชื่อมต่อเครือข่ายไปยังปลายทาง

การกำหนดค่า

ไปที่หน้าจอการส่งออกอัตโนมัติจากเมนูหลัก แล้วแตะ "ระบบอัตโนมัติใหม่" และเลือก "REST API" เป็นประเภทระบบอัตโนมัติ

ชื่อระบบอัตโนมัติ

ตั้งชื่อที่อธิบายได้ (เช่น "My Backend API", "Webhook Integration")

การแจ้งเตือน

กำหนดเมื่อต้องการรับการแจ้งเตือน:

• Notify on Cache Update — แจ้งเมื่ออัปเดตข้อมูลแคช
• Notify When Run — แจ้งทุกครั้งที่ระบบอัตโนมัติรัน

การตั้งค่า URL

ใส่ URL เต็มที่ต้องการส่งข้อมูลสุขภาพ รวมโปรโตคอล (http:// หรือ https://)

ตัวอย่าง URL:

• https://api.example.com/health-data
• https://webhook.site/your-unique-id
• http://localhost:3000/api/health

หมายเหตุ: URL ต้องถูกต้องและเข้าถึงได้จากอุปกรณ์ URL ไม่ถูกต้องจะทำให้ระบบอัตโนมัติรันไม่ได้

หมดเวลาคำขอ

เลือกช่วงหมดเวลาสำหรับคำขอ HTTP กำหนดว่าแอปจะรอการตอบกลับนานแค่ไหนก่อนถือว่าล้มเหลว

HTTP Headers

เพิ่มส่วนหัว HTTP สำหรับการยืนยันตัวตนหรือเมทาดาทา ตัวอย่าง:

• API keys: X-API-Key: your-api-key
• Authorization tokens: Authorization: Bearer your-token
• Content type: Content-Type: application/json

วิธีเพิ่ม:

1. แตะ "Add Headers"
2. ใส่ชื่อ header ในช่องซ้าย
3. ใส่ค่า header ในช่องขวา
4. ทำซ้ำสำหรับ header เพิ่มเติม

สำคัญ: แต่ละคีย์ต้องมีค่าคู่กัน header ว่างจะถูกละเว้น

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

ประเภทข้อมูล

เลือกประเภทข้อมูลสุขภาพที่จะส่งออก:

• ตัวชี้วัดสุขภาพ — ก้าว อัตราการเต้น การนอน และการวัดอื่น ๆ
• การออกกำลังกาย — กิจกรรมออกกำลังกายและฟิตเนส
• อาการ — อาการและภาวะสุขภาพ
• ECG — การบันทึกคลื่นไฟฟ้าหัวใจ
• การแจ้งเตือนอัตราการเต้น — เหตุการณ์อัตราสูง/ต่ำ
• สภาวะทางจิตใจ — อารมณ์และสภาวะจิตใจ (iOS 18.0+)
• การติดตามรอบเดือน — ข้อมูลรอบเดือนและสืบพันธุ์
• ยา — บันทึกยาและการปฏิบัติตาม (iOS 26.0+)

การตั้งค่าตัวชี้วัดสุขภาพ

เมื่อเลือกตัวชี้วัดสุขภาพ:

เลือกตัวชี้วัดสุขภาพ — เลือกตัวชี้วัดที่รวม ทั้งหมดหรือเฉพาะรายการ

เคล็ดลับ: เลือกเฉพาะที่จำเป็นช่วยลดเวลาประมวลผลและขนาดข้อมูล

แหล่งข้อมูลที่ต้องการ — กำหนดลำดับความสำคัญของแหล่งข้อมูลเมื่อมีหลายแหล่งให้ตัวชี้วัดเดียวกัน

การตั้งค่าการออกกำลังกาย

เมื่อเลือกการออกกำลังกาย:

รวมข้อมูลเส้นทาง — เปิดเพื่อรวมเส้นทางเมื่อมีข้อมูลตำแหน่ง

รวมตัวชี้วัดการออกกำลังกาย — เปิดเพื่อรวมตัวชี้วัดที่เก็บระหว่างออกกำลังกาย (อัตราการเต้น แคลอรี่ ฯลฯ)

การจัดกลุ่มตามเวลา (ตัวชี้วัดการออกกำลังกาย) — เมื่อใช้ Export Version 2 และเปิดรวมตัวชี้วัดการออกกำลังกาย:

• นาที — จัดกลุ่มตามนาที
• วินาที — จัดกลุ่มตามวินาที

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

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

เลือกรูปแบบข้อมูลที่ส่งออก:

• JSON — โครงสร้างละเอียดมีอ็อบเจ็กต์ซ้อน เหมาะกับ API ฐานข้อมูล และแอปที่ต้องการโครงสร้าง JSON มีรายละเอียดมากขึ้นสำหรับข้อมูลซับซ้อน เช่น ระยะการนอนและการอ่าน AFib

• CSV — ข้อมูลตารางนำเข้าสเปรดชีตได้ง่าย เหมาะกับการวิเคราะห์ง่าย ๆ หรือเมื่อปลายทางต้องการ CSV

หมายเหตุ: Content-Type ตั้งเป็น application/json สำหรับ JSON และ multipart/form-data สำหรับ CSV โดยอัตโนมัติ

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

เลือกเวอร์ชันการส่งออก การมีเวอร์ชันช่วยให้เปลี่ยนรูปแบบใหม่ได้ตามจังหวะและลดการเปลี่ยนที่ทำลายเวิร์กโฟลว์

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

ช่วงวันที่

เลือกว่าควรส่งออกข้อมูลเมื่อใด:

• Default — ซิงก์ข้อมูลวันก่อนหน้าเต็มวัน รวมถึงข้อมูลจนถึงวันเวลาปัจจุบัน
• Since Last Sync — แต่ละครั้งส่งข้อมูลตั้งแต่ครั้งซิงก์ล่าสุดจนถึงปัจจุบัน
• Today — ข้อมูลวันนี้จนถึงเวลาปัจจุบัน
• Yesterday — ข้อมูลวันก่อนเต็มวัน
• Previous 7 Days — ข้อมูลเจ็ดวันก่อนเต็มวัน

สรุปข้อมูล

เมื่อใช้ JSON กับประเภทตัวชี้วัดสุขภาพ เปิดหรือปิดสรุปข้อมูล

• เปิด — ให้สรุปรวม
• ปิด — แยกจุดข้อมูลเมื่อทำได้

หมายเหตุ: ใช้กับ JSON และตัวชี้วัดสุขภาพเท่านั้น ข้อมูลจะรวมเสมอเมื่อใช้ CSV หรือเลือกหลายตัวชี้วัด

การจัดกลุ่มตามเวลา

เมื่อใช้ JSON และเปิดสรุปข้อมูล เลือกวิธีรวมข้อมูล

หมายเหตุ: CSV รวมข้อมูลเสมอ การจัดกลุ่มระดับนาทีหรือวินาทีอาจเพิ่มเวลาประมวลผลและขนาดข้อมูลมาก

คำขอแบบแบตช์

เมื่อใช้ JSON เปิด Batch Requests เพื่อส่งข้อมูลเป็นหลายคำขอแทนครั้งเดียว

• เปิด — แบ่งข้อมูลหลายคำขอเพื่อหลีกเลี่ยง payload ใหญ่เกินไป
• ปิด — ส่งข้อมูลทั้งหมดในคำขอเดียว

ความถี่การซิงก์

กำหนดความบ่อยของการอัปโหลด:

เลือกตัวเลขและช่วงเวลา

การทดสอบและการตรวจสอบ

ทดสอบด้วยตนเอง

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

ดูบันทึกกิจกรรม

1. แตะ "View Activity Logs" ในหน้าจอตั้งค่าระบบอัตโนมัติ
2. ทบทวันการรันล่าสุด
3. ตรวจสอบข้อผิดพลาดหรือคำเตือน
4. ยืนยันเวลาคำขอและสถานะการตอบกลับ

ตรวจสอบรูปแบบข้อมูล

แอปรวมส่วนหัวต่อไปนี้ในแต่ละคำขอโดยอัตโนมัติ:

• Content-Type — ตามรูปแบบการส่งออก
• automation-name — ชื่อระบบอัตโนมัติ
• automation-id — ตัวระบุเฉพาะ
• automation-aggregation — การจัดกลุ่มตามเวลาที่เลือก
• automation-period — ช่วงวันที่ที่เลือก
• session-id — ตัวระบุเฉพาะของแต่ละคำขอ

การแก้ปัญหา

ปัญหาที่พบบ่อย

ข้อมูลไม่ถึงปลายทาง

• ตรวจสอบ URL ปลายทาง
• ตรวจสอบว่าปลายทางรับ POST
• ทบทวันส่วนหัวการยืนยันตัวตน
• ดูบันทึกปลายทาง
• ตรวจสอบการเชื่อมต่อเครือข่าย

เคล็ดลับและแนวทางปฏิบัติ

1. การซิงก์อัตโนมัติ:

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

2. ประสิทธิภาพ:

   • ใช้การจัดกลุ่มตามเวลาที่เหมาะสมสมดุลระหว่างรายละเอียดกับขนาด
   • เลือกเฉพาะตัวชี้วัดที่จำเป็น

3. ความน่าเชื่อถือ:

   • ตั้งหมดเวลาให้เหมาะกับเวลาตอบของปลายทาง
   • ตรวจสอบบันทึกกิจกรรมเป็นประจำ

4. รูปแบบข้อมูล:

   • ใช้ JSON สำหรับข้อมูลมีโครงสร้างและ API
   • ใช้ CSV สำหรับการวิเคราะห์ง่ายหรือเชื่อมสเปรดชีต
   • พิจารณา batch สำหรับชุดข้อมูลใหญ่หรือแยกประมวลผล