用途:通过 Strava REST API 访问健身活动数据,适用于跑步、骑行等运动记录查询与管理。
主要能力:获取认证运动员资料与统计;列出近期活动、查看活动详情、创建手动活动、更新活动;上传 GPX/FIT/TCX 文件并轮询处理状态;查看评论、点赞、圈速与 GPS/心率/功率等数据流;查询收藏分段、装备、俱乐部与路线。
使用方式:所有请求需在请求头携带 Authorization: Bearer $STRAVA_TOKEN。例如获取运动员资料:curl -s "https://www.strava.com/api/v3/athlete" --header "Authorization: Bearer $STRAVA_TOKEN"。创建活动需先写入 /tmp/strava_request.json,再执行 curl -s -X POST "https://www.strava.com/api/v3/activities" --header "Authorization: Bearer $STRAVA_TOKEN" --header "Content-Type: application/json" -d @/tmp/strava_request.json。上传文件使用 curl -s -X POST "https://www.strava.com/api/v3/uploads" --header "Authorization: Bearer $STRAVA_TOKEN" -F "data_type=gpx" -F "file=@/path/to/activity.gpx"。
限制:访问令牌每 6 小时过期,平台通过连接器自动刷新;列表接口使用 page 与 per_page(最大 200)分页;before/after 使用 Unix 时间戳;私有活动需 activity:read_all 权限,创建或编辑需 activity:write;速率限制为每 15 分钟 200 次、每天 2000 次,超限返回 429;距离单位为米,速度单位为米/秒,时长单位为秒;建议使用 sport_type 而非已弃用的 type 字段。故障排查可运行 zero doctor check-connector --env-name STRAVA_TOKEN 或 zero doctor check-connector --url https://www.strava.com/api/v3/athlete --method GET。
适用场景:运动数据查询、活动记录管理、批量上传与数据分析。