Intervals.icu API 是一套完整的训练数据访问与管理接口，专为运动员和教练设计，用于与 Intervals.icu 平台进行深度集成。该 API 支持对运动员档案、已完成活动（Activities）、计划训练日程（Events）以及健康恢复数据（Wellness）进行全面的增删改查操作。通过标准化的 RESTful 接口，开发者可以自动化同步训练记录、批量导入或导出训练计划、监控训练负荷与恢复状态，并与其他第三方系统无缝对接。API 采用灵活的认证机制，支持基于 API Key 的简单授权方式，也兼容 OAuth 的 Bearer Token 模式，确保数据传输的安全性。所有请求均基于统一的 Base URL `https://intervals.icu/api/v1`，并以 ISO-8601 格式处理日期时间，保证全球一致性。无论是获取历史骑行功率曲线、下载结构化训练文件（如 .zwo、.mrc、.erg），还是创建新的训练目标，Intervals.icu API 都提供了清晰、高效的编程路径，是构建个性化训练管理平台的核心工具。
核心功能特点
- 支持通过 API Key 或 OAuth Bearer Token 进行身份验证
- 可查询和筛选指定日期范围内的已完成活动（Activities），包含 GPS、功率、心率等详细数据流
- 提供日历事件（Events）管理功能，支持创建、更新和下载各类训练计划文件（如 Zwift、TrainerRoad、Wahoo 格式）
- 允许手动录入或批量导入训练活动，支持外部 ID 映射以避免重复
- 具备完善的健康与恢复数据接口，包括睡眠时长、静息心率、疲劳度和主观感受记录
- 支持动态更新运动员的训练区设置（如 FTP、HR 区间、功率区间），并可实时重新计算相关指标
适用场景
Intervals.icu API 特别适合需要与训练管理系统深度集成的场景。例如，健身应用开发者可以利用该 API 自动拉取用户的最新骑行或跑步数据，结合自定义算法生成个性化反馈报告；教练团队可通过批量创建周训练计划，将结构化 workouts 直接推送到运动员的日历中，并支持一键导出至主流智能骑行台或跑步设备。对于数据分析师而言，API 提供的 wellness 和健康指标接口使其能够构建综合性的训练负荷与恢复模型，分析 ATL/CTL 趋势与伤病风险关联。此外，Strava、Garmin Connect 等平台的用户也可借助此 API 实现双向数据同步，避免在多个平台间手动重复录入。无论是自动化周报生成、跨平台训练计划分发，还是高级训练效果追踪，Intervals.icu API 都能显著提升训练管理的效率与精准度，成为专业运动员和团队不可或缺的技术基础设施。