我們的承諾
- 重大變更至少提前 90 天公告,除非安全或法律緊急情況需要立即變更。
- 我們在每個回應的
X-API-Version標頭發布版本日期(目前為2026-07-01)。 重大變更以新版本日期發布;前一版本在公告期內持續有效。 - 新增變更不屬於重大變更。 回應中可能隨時新增欄位,也可能隨時新增端點。 請建構你的用戶端以忽略未知欄位。
什麼算作重大變更
- 移除或重新命名端點、欄位、存取範圍或錯誤代碼
- 變更現有欄位的型別或含義
- 收緊驗證規則,導致先前有效的請求被拒絕
- 降低請求頻率限制
掌握最新資訊
重大變更通知發布於資料可攜承諾頁面及其變更記錄。 機器可讀的 OpenAPI 規格 始終反映目前版本——透過比對差異即可確切了解變更內容。目前限制
這是 v1。部分功能目前尚未提供:- 僅供讀取與匯出——尚無寫入或提議端點,也無 webhooks。
- GPX / FIT / TCX 匯出格式尚未提供(目前僅限 CSV 與 JSON)。
- 部分原始廠商資料可能受上游提供商條款限制,不包含在匯出中。