intervals-icu-api

🚴 专业级训练数据同步助手

Intervals.icu API 完整指南,支持训练活动、计划及健康数据管理,为耐力运动员提供专业数据同步方案。

收藏
1.7k
安装
464
版本
v2.0.1
CLS 安全性认证2026-05-04
点击查看完整报告 >

使用说明

Intervals.icu API Skill 是一份专为耐力运动爱好者和教练员设计的综合性 API 使用指南,旨在帮助用户通过编程方式高效管理训练数据。该技能提供了完整的 Intervals.icu 平台接口文档,涵盖从基础认证到高级数据操作的完整工作流程。

核心用法方面,该技能支持多种数据交互场景。用户可以通过 API Key 或 OAuth 认证方式访问运动员资料,检索包含功率、心率、训练负荷等详细字段的活动记录。对于训练规划,支持创建、更新和导出结构化训练计划到 Zwift、TrainerRoad、Garmin 等主流平台格式。此外,还提供了健康数据追踪功能,包括睡眠质量、疲劳程度、静息心率等恢复指标的管理,以及运动设置和功率区间的配置。

显著优点体现在功能的全面性和灵活性上。首先,文档提供了 30 余个实用的 curl 命令示例,覆盖读取、写入、批量操作等全场景,降低了开发者的接入门槛。其次,支持字段级筛选(fields 参数),用户可以按需获取特定数据,显著提升 API 调用效率。再者,具备完善的批量操作能力,可一次性创建整周训练计划或更新多条记录。同时,支持将训练计划导出为 .zwo、.mrc、.erg、.fit 等多种设备格式,实现训练数据的无缝流转。

潜在局限性主要包括来源可信度与功能边界。该技能来源于 T3 级个人开发者账号,虽然内容经过安全审计,但相较于官方或企业级来源(T1/T2),长期维护的稳定性存在不确定性。此外,作为纯文档型技能,它仅提供 API 调用指导,不具备自动化执行能力,所有操作仍需用户手动或通过自行编写的脚本完成。功能上也仅限于 Intervals.icu 平台,无法直接对接 Strava、TrainingPeaks 等其他平台。

适合的目标群体主要包括三类人群:一是严肃耐力运动员(骑行、跑步、铁人三项),需要深度分析训练数据并制定周期化计划;二是运动教练员,需要为多名运动员批量管理训练安排;三是具备开发能力的数据分析师,希望将 Intervals.icu 数据集成到自建的分析系统或仪表板中。

使用该技能存在的常规风险主要涉及 API 使用规范与数据安全。Intervals.icu 平台实施速率限制,高频调用可能导致账号被临时封禁。用户需要妥善管理 API Key,避免在公共代码仓库中硬编码凭据。此外,作为第三方平台 API,存在服务条款变更或接口调整的可能性,建议关注官方论坛更新。数据写入操作具有破坏性,批量更新前建议备份重要训练记录。

安全解读

核心功能

intervals-icu-api 是面向耐力运动员和教练的 intervals.icu 平台 API 完整操作手册,涵盖训练数据全生命周期管理。

主要能力

  • 活动数据查询:支持按日期范围检索已完成训练,可指定字段组合(功率、心率、训练负荷、CTL/ATL 等)实现高效查询
  • 日历事件管理:创建/更新计划训练(WORKOUT)、备注(NOTE)、目标(TARGET),支持 Zwift、TrainerRoad、Garmin 等多设备格式导出
  • 健康恢复追踪:读写睡眠、静息心率、疲劳度等 wellness 数据
  • 运动设置配置:动态调整 FTP、功率区间、心率区间

显著优势

1. 专业级训练分析:深度整合 PMC(性能管理曲线)数据,支持 icu_training_loadicu_ctlicu_atl 等高级指标
2. 多格式兼容:原生支持 .zwo/.mrc/.erg/.fit 等主流训练设备格式

3. 批量操作友好:提供 bulk 接口实现周计划批量创建、wellness 数据批量更新

4. 字段裁剪优化:通过 fields 参数精确控制返回数据,降低传输开销

局限性

  • 纯文档型技能:仅提供 curl 示例,无 SDK 封装或自动化重试机制
  • 需自行处理认证:API Key 需用户从 intervals.icu 后台手动获取
  • 无实时 WebSocket 支持:需轮询获取数据更新
  • 来源为社区维护(T3),非 intervals.icu 官方发布

适合人群

  • 铁三/自行车/跑步运动员自建数据看板
  • 运动数据分析师构建自定义报告
  • 教练开发自动化训练计划分发系统
  • 开发者对接 intervals.icu 与第三方平台(Strava、TrainingPeaks 等)

常规风险

  • 凭证泄露风险:curl 示例中需嵌入 API Key,用户若硬编码于脚本可能导致泄露
  • 误操作风险upsertOnUid 参数使用不当可能覆盖已有计划
  • 速率限制:高频调用可能触发 429 限流
  • 数据一致性:批量操作失败时需自行实现事务回滚逻辑

安全等级说明

经 CLS-Certify 扫描认证,该技能为纯 Markdown 文档,无可执行代码、无敏感信息硬编码、无危险函数调用,安全等级 A(85分),数据外泄风险极低。

intervals-icu-api 内容

手动下载zip · 8.1 kB
README.mdtext/markdown
请选择文件