intervals-icu-api

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，存在服务条款变更或接口调整的可能性，建议关注官方论坛更新。数据写入操作具有破坏性，批量更新前建议备份重要训练记录。