Garmin Personal API: ให้ AI ช่วยอ่านข้อมูลของคุณเอง
ตั้งแต่ตุลาคม 2026 ผู้ใช้ Garmin Connect ทุกคนสร้างคีย์ API ส่วนตัวได้ และดึงข้อมูลกิจกรรม การนอน HRV และ Body Battery ของตัวเองออกมาเป็นข้อมูลได้ แต่คีย์อย่างเดียวยังใช้กับแชต AI ไม่ได้ ต้องมีโปรแกรมนำคีย์ไปแลกเป็นโทเค็นแล้วดึงข้อมูลมาให้ หน้านี้สรุปว่า API ให้ข้อมูลอะไรจริง ๆ สร้างคีย์อย่างไร และควรเชื่อมต่อแบบไหนกับ Claude, ChatGPT หรือผู้ช่วย AI อื่น
ทำงานอย่างไร
- Garmin Connectบัญชีของคุณ
- คีย์ API ส่วนตัวแสดงเพียงครั้งเดียว
- โทเค็นเข้าถึงใช้ได้ 24 ชั่วโมง
- ข้อมูลของคุณไฟล์ JSON และ FIT
- ผู้ช่วย AIอ่านอย่างเดียว
คุณสร้างคีย์เพียงครั้งเดียวบนเว็บไซต์ Garmin Connect จากนั้นโปรแกรมจะนำคีย์ไปแลกเป็นโทเค็นที่ใช้ได้ 24 ชั่วโมง แล้วอ่านข้อมูลจาก Garmin ข้อมูลสุขภาพและสรุปกิจกรรมมาเป็น JSON ส่วนกิจกรรมที่บันทึกไว้มาเป็นไฟล์ FIT ต้นฉบับ เขียนข้อมูลกลับไม่ได้ ผู้ช่วย AI เห็นเฉพาะข้อมูลที่โปรแกรมดึงมาเท่านั้น
ได้ข้อมูลอะไรบ้าง
เราตรวจสอบข้อมูลทุกชุดด้วยบัญชีจริงเมื่อวันที่ 18 พฤศจิกายน 2026 คอลัมน์กลางคือช่วงวันที่ยาวที่สุดที่ขอได้ในหนึ่งครั้ง ถ้าต้องการช่วงที่ยาวกว่านั้นให้ดึงเป็นส่วน ๆ
| ข้อมูล | ต่อหนึ่งครั้ง | มีอะไรบ้าง |
|---|---|---|
| กิจกรรม | ประวัติทั้งหมด ทีละหน้า | ระยะทาง เพซ อัตราการเต้นของหัวใจและโซน ภาระการฝึกและผลการฝึก รายละเอียดและรอบ ไฟล์ FIT ต้นฉบับ |
| การนอน | 1 คืน หรือสรุป 1 เดือน | เวลาหลับลึก หลับตื้น REM และตื่น ความต้องการการนอน |
| HRV | สรุปได้สูงสุด 1 ปี | ค่าเฉลี่ยตอนกลางคืน ค่าเฉลี่ย 7 วัน ค่าพื้นฐาน และสถานะ |
| Body Battery | 1 เดือน (31 วัน) | พลังงานที่ชาร์จ ที่ใช้ไป และค่าตลอดวัน |
| ความเครียดและจำนวนก้าว | 28 วัน | ค่ารายวัน |
| สรุปรายวัน | สูงสุด 1 ปี | Body Battery อัตราการเต้นของหัวใจ ความเครียด นาทีความหนัก การหายใจ Pulse Ox แคลอรี |
| VO2 max | สูงสุด 1 ปี | ค่าสำหรับวิ่งและปั่นจักรยาน |
| อัตราการเต้นของหัวใจ, SpO2 | 1 วัน | อัตราการเต้นของหัวใจขณะพัก ค่าตลอดวัน ค่าเฉลี่ย SpO2 |
| อื่น ๆ | — | น้ำหนัก การดื่มน้ำ โซนอัตราการเต้นของหัวใจ อายุสมรรถภาพ รอบเดือน บันทึกอาหาร การตั้งค่าโปรไฟล์ |
Garmin ไม่ได้เปิดเผยขีดจำกัดจำนวนคำขอ และเงื่อนไขอนุญาตให้เปลี่ยนได้ทุกเมื่อ
สิ่งที่ไม่ได้
ข้อมูลเหล่านี้ตอบกลับว่า «ไม่พบ» ในการทดสอบ หรือไม่รวมอยู่ในคีย์ส่วนตัวเลย:
- Training Readiness และสถานะการฝึก
- การคาดการณ์เวลาแข่งและสถิติส่วนตัว
- การฝึกที่บันทึกไว้ ปฏิทินการฝึก อุปกรณ์เสริม และรายการอุปกรณ์ของคุณ
- การเขียนข้อมูลทุกอย่าง: AI ส่งการฝึกหรือเส้นทางไปที่นาฬิกาไม่ได้ ต้องใช้ Training API และ Courses API ของ Garmin ซึ่งเปิดให้เฉพาะพาร์ตเนอร์ธุรกิจที่ได้รับอนุมัติ
- ข้อมูลแบบเรียลไทม์: ข้อมูลจะมีหลังนาฬิกาซิงค์แล้ว และเฉพาะตอนที่โปรแกรมขอเท่านั้น
✓ VO2 max ดึงได้ แม้คู่มือช่วงแรกบางฉบับจะบอกว่าไม่ได้
ขั้นที่ 1: สร้างคีย์
- เปิด Garmin Connect ในเบราว์เซอร์บนคอมพิวเตอร์แล้วลงชื่อเข้าใช้
- ไปที่หน้าคีย์ API ส่วนตัวในการตั้งค่า (ลิงก์ด้านล่าง)
- เลือกสร้างคีย์ แล้วอ่านเงื่อนไขเพิ่มเติม: คีย์ใช้ได้เฉพาะคุณ และห้ามให้ผู้อื่น
- เลือกอายุของคีย์: 30, 90 หรือ 180 วัน หรือ 1 ปี เลือกช่วงที่สั้นที่สุดเท่าที่จำเป็น
- คัดลอกคีย์ทันทีแล้วเก็บไว้ในโปรแกรมจัดการรหัสผ่าน Garmin แสดงคีย์เพียงครั้งเดียว ถ้าทำหายให้ลบแล้วสร้างใหม่
Garmin จะส่งอีเมลเตือนประมาณหนึ่งสัปดาห์ก่อนคีย์หมดอายุ เมื่อลบคีย์ ทั้งคีย์และโทเค็นทุกตัวที่สร้างจากคีย์นั้นจะใช้ไม่ได้ทันที
ขั้นที่ 2: ให้ผู้ช่วย AI อ่านข้อมูล
ทั้ง Claude และ ChatGPT ใช้คีย์เองโดยตรงไม่ได้ เลือกวิธีที่ตรงกับแอปที่คุณใช้
- ง่ายและปลอดภัยที่สุด
ผู้ช่วยที่รันคำสั่งบนคอมพิวเตอร์ของคุณได้
Claude Code, OpenAI Codex CLI, Cursor และเครื่องมือคล้ายกันสามารถรันไคลเอนต์บรรทัดคำสั่งอย่างเป็นทางการของ Garmin ได้ ติดตั้งไคลเอนต์ (Python 3.12 ขึ้นไป) บันทึกคีย์เป็นบรรทัดเดียวใน ~/.config/garmin/connect-personal-api-key แล้วบอกผู้ช่วยให้ใช้ gc-personal คีย์จะอยู่ในไฟล์ ผู้ช่วยอ่านเฉพาะ JSON ที่ไคลเอนต์แสดงออกมา
python3 -m pip install garmin-connect-personal-api-python chmod 600 ~/.config/garmin/connect-personal-api-key gc-personal sleep-summaries \ --start-date 2026-10-21 --end-date 2026-11-17 - เซิร์ฟเวอร์ในเครื่อง
Claude Desktop และแอปอื่นที่รองรับ MCP
Claude Desktop อ่านข้อมูลภายนอกผ่านเซิร์ฟเวอร์ MCP ที่รันบนคอมพิวเตอร์ของคุณ Garmin ไม่มีเซิร์ฟเวอร์ทางการ แต่มีเซิร์ฟเวอร์โอเพนซอร์สหลายตัวที่ใช้ Personal API เลือกตัวที่อ่านโค้ดได้ ใช้แบบอ่านอย่างเดียว และใส่คีย์ในการตั้งค่าของเซิร์ฟเวอร์ในเครื่อง ไม่ใช่ในแชต
- แนบไฟล์
ChatGPT, Gemini และแชตบนเว็บอื่น ๆ
แชตบนเว็บเข้าถึงโปรแกรมบนคอมพิวเตอร์ของคุณไม่ได้ ให้ส่งออกข้อมูลด้วยไคลเอนต์ทางการแล้วแนบไฟล์ JSON ในแชต ตัวเชื่อมต่อแบบกำหนดเองของ ChatGPT ต้องใช้เซิร์ฟเวอร์บนอินเทอร์เน็ต ซึ่งหมายความว่าคีย์ของคุณต้องอยู่บนเซิร์ฟเวอร์นั้น
gc-personal --quiet body-battery \ --start-date 2026-10-18 --end-date 2026-11-17 \ > body-battery.json
✕ ห้ามวางคีย์ในแชต ภาพหน้าจอ หรือเอกสารที่แชร์
✓ ให้ AI อ่านข้อมูล ไม่ใช่คีย์
บริการเชื่อมต่อภายนอกกับเงื่อนไขของ Garmin
บางบริการบนเว็บเสนอเชื่อม Garmin กับ ChatGPT หรือ Claude ให้ ถ้าบริการขอให้วางคีย์ API ส่วนตัว นั่นคือการมอบคีย์ให้บุคคลที่สาม ซึ่งเงื่อนไขเพิ่มเติมของ Garmin ไม่อนุญาต และคีย์อาจถูกเพิกถอน บริการที่ทำงานผ่านโปรแกรมธุรกิจของ Garmin จะขอความยินยอมผ่านช่องทางที่ได้รับอนุมัติของตัวเอง และไม่ต้องใช้คีย์ส่วนตัวของคุณเลย ตรวจสอบให้แน่ใจว่าเป็นแบบไหนก่อนสมัคร
ตัวอย่างคำถามที่ได้ผล
ขอให้ดึงข้อมูลและวิเคราะห์ในข้อความเดียว ตัวอย่างเช่น:
- ดึงสรุปการนอนและ Body Battery ของ 4 สัปดาห์ล่าสุด คืนไหนฟื้นตัวแย่ที่สุด และวันก่อนหน้าฉันทำอะไร
- แสดงการวิ่งทั้งหมดของปีนี้พร้อมระยะทาง เพซ และอัตราการเต้นของหัวใจเฉลี่ย ที่เพซเดียวกัน อัตราการเต้นของหัวใจลดลงไหม
- เปรียบเทียบสถานะ HRV ของ 3 เดือนล่าสุดกับภาระการฝึกรายสัปดาห์
- ดาวน์โหลดไฟล์ FIT ของการวิ่งยาวครั้งล่าสุด แล้วแสดงเพซและอัตราการเต้นของหัวใจในแต่ละกิโลเมตร
- ดึงข้อมูลความเครียดของ 3 เดือนล่าสุดทีละ 28 วัน แล้วบอกว่าวันไหนของสัปดาห์หนักที่สุด
ดูแลข้อมูลให้ปลอดภัย
- คีย์คือทางเข้าข้อมูลสุขภาพของคุณ เก็บไว้เหมือนรหัสผ่าน และตั้งอายุให้สั้นที่สุดเท่าที่ใช้งานได้
- ตั้งไฟล์คีย์ให้คุณอ่านได้คนเดียว (chmod 600) และอย่าใส่ไว้ใน git โฟลเดอร์คลาวด์ หรือข้อมูลสำรองที่แชร์
- ข้อมูลที่ AI อ่านจะถูกส่งไปยังผู้ให้บริการ AI นั้น ตรวจสอบการตั้งค่าข้อมูล เช่น แชตถูกนำไปใช้ฝึกโมเดลหรือไม่
- ใช้งานเสร็จแล้ว? ลบคีย์ที่หน้าคีย์ API ส่วนตัว
คำถามที่พบบ่อย
Garmin Personal API ใช้ฟรีไหม
ฟรี บัญชี Garmin Connect ทุกบัญชีสร้างคีย์ส่วนตัวได้ ไม่ต้องสมัครและไม่ต้องมีบัญชีนักพัฒนา
ใช้กับนาฬิการุ่นไหนได้บ้าง
API อ่านข้อมูลจาก Garmin Connect ไม่ใช่จากนาฬิกา จึงครอบคลุมทุกอย่างที่นาฬิกาซิงค์ไว้ ค่าที่มีขึ้นอยู่กับรุ่น เช่น สถานะ HRV หรือ Body Battery จะมีเฉพาะเมื่อนาฬิกาบันทึกค่านั้น
ChatGPT หรือ Claude เปลี่ยนแปลงอะไรในบัญชี Garmin ได้ไหม
ไม่ได้ คีย์ส่วนตัวอ่านได้อย่างเดียว ส่งการฝึก เส้นทาง หรือการตั้งค่าไปที่นาฬิกาไม่ได้
โทเค็นเข้าถึงใช้ได้นานแค่ไหน
24 ชั่วโมง หรือจนกว่าคีย์จะหมดอายุ แล้วแต่อย่างไหนถึงก่อน ไม่มีรีเฟรชโทเค็น โปรแกรมจะใช้คีย์ขอโทเค็นใหม่ และไคลเอนต์ทางการของ Garmin ทำให้อัตโนมัติ
ทำคีย์หาย ดูอีกครั้งได้ไหม
ไม่ได้ Garmin แสดงคีย์เพียงครั้งเดียว ให้ลบแล้วสร้างคีย์ใหม่
ดู Body Battery หรือ HRV บนนาฬิกาได้เลยไหม
ได้ หน้าปัดหลายแบบแสดงค่าเหล่านี้บนข้อมือได้เลย กรองแคตตาล็อกตามรุ่นนาฬิกาของคุณเพื่อหาหน้าปัด
เกี่ยวข้อง
ตรวจสอบเมื่อวันที่ 18 พฤศจิกายน 2026 กับ Personal API ของ Garmin ด้วยบัญชีจริง Garmin อาจเปลี่ยนชุดข้อมูลและขีดจำกัดได้
WatchFaceKit ไม่มีส่วนเกี่ยวข้องกับ Garmin, Anthropic หรือ OpenAI Garmin และ Garmin Connect เป็นเครื่องหมายการค้าของ Garmin Ltd. หรือบริษัทในเครือ Claude เป็นเครื่องหมายการค้าของ Anthropic และ ChatGPT เป็นเครื่องหมายการค้าของ OpenAI