Intervals训练数据管理

技能简介

本技能提供完整的 intervals.icu API 操作指南，用于访问和管理运动员训练数据。支持获取活动记录、管理日历事件、处理训练计划及健康数据，涵盖 API 认证、数据字段筛选、批量导出等核心功能。

业务背景

为教练团队和自主训练运动员提供标准化的训练数据调取能力，解决多平台数据分散问题。通过API直接获取功率、心率、训练负荷等核心指标，支持按日期筛选和字段定制，便于整合到自有分析系统或生成周期性训练报告，提升训练管理的自动化程度。

落地案例：教练需要汇总队员本月的骑行数据，调用API按日期范围拉取活动列表，筛选功率和训练负荷字段生成对比表格。运动员想分析某次间歇训练的细节，导出该活动的流数据为CSV，导入Excel查看每分钟功率波动。团队还可将API接入内部系统，自动同步训练计划到队员日历并跟踪完成情况。

能做什么

• 通过 API Key 或 OAuth Bearer Token 完成身份验证
• 按日期范围检索已完成的活动（骑行、跑步、游泳等）
• 使用 fields 参数组合功率、心率、训练负荷等数据字段
• 导出活动流数据为 JSON 或 CSV 格式
• 管理日历中的计划训练事件和 workouts
• 创建和更新训练数据与 wellness 信息

使用说明

安装准备：无需安装软件包，仅需 curl 命令行工具（Linux/macOS 自带，Windows 需下载）。从 intervals.icu 设置页获取 Athlete ID 和 API Key。

基础调用步骤：

1. 设置认证头：-H "Authorization: ApiKey API_KEY:YOUR_API_KEY"
2. 构造请求 URL：https://intervals.icu/api/v1/athlete/{id}/activities
3. 添加查询参数：oldest/newest 指定日期范围，fields 筛选返回字段
4. 解析 JSON 响应，按需过滤活动类型

常用示例：

# 获取某月骑行数据
curl -H "Authorization: ApiKey API_KEY:$KEY" \
  "https://intervals.icu/api/v1/athlete/$ID/activities?oldest=2024-01-01&newest=2024-01-31" | jq '.[] | select(.type == "Ride")'

# 导出功率心率流数据
curl -H "Authorization: ApiKey API_KEY:$KEY" \
  "https://intervals.icu/api/v1/activity/$ACT_ID/streams.csv" --output streams.csv

输入与输出

见下方输入与输出表格。

风险提示

• API Key 等同于账户密码，勿提交到公共代码仓库
• 频繁调用可能触发速率限制，建议缓存响应数据
• 日期格式须严格遵循 ISO-8601，否则返回空结果
• athlete_id 错误会导致 404，请核对设置页数值
• 流数据 CSV 可能包含敏感位置信息，分享前脱敏处理

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/pseuss/intervals-icu-api/SKILL.md
来源类型：GitHub 技能文档