（4027期）intervals-icu-api – 专业级训练数据同步助手

专业级训练数据同步助手 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，存在服务条款变更或接口调整的可能性，建议关注官方论坛更新。数据写入操作具有破坏性，批量更新前建议备份重要训练记录。 原始说明 Complete guide for accessing and managing training data with the intervals.icu API. Use when working with Intervals.icu athlete profiles, activities, workouts, events, wellness data, and training plans. Covers authentication, retrieving activities with combined data fields, managing calendar events with planned workouts, and creating/updating training data. Includes curl examples for all major operations.