Exercise Database Workout Planner and Muscle Map

873 gym, home and calisthenics exercises with step-by-step instructions and 1,746 exercise images, tagged by equipment, force, mechanic and the muscle groups they hit. Workout plan generator that respects the equipment you own, exercise alternatives when a machine is busy, and an anatomy SVG muscle map. Strength training, cardio and stretching. Public domain data, no attribution required.

原始信息汇总

数据集概述

数据集名称： Exercise Database Workout Planner and Muscle Map

数据集提供者： Nick Illig

类别： 健康与健身（Health and Fitness）

数据集简介：

该数据集包含873个健身、居家及徒手训练动作，每个动作均带有逐步指导说明，并配有起始和结束位置的两张图片（共1,746张图片）。动作按器械、发力方式（force）、动作机制（mechanic）和涉及的肌肉群进行标签分类，涵盖力量训练、拉伸、增强式训练、力量举、大力士训练、奥林匹克举重和有氧运动等多种类型。

---

核心功能

1. 训练动作数据库

   • 873个训练动作，涵盖多种训练类型。
   • 每个动作包含发力方式、难度等级、动作机制、所需器械、主要和次要肌肉、逐步指导说明及两张图片（起始和结束位置）。
   • 支持更细粒度的肌肉列表，同时包含bodyPart和target字段，便于与现有健身应用兼容。

2. 训练周计划生成器

   • 通过POST /v1/workout/plan接口，根据用户目标、训练水平、训练天数、可用时间和拥有的器械，生成一周训练计划。
   • 返回内容包括训练分割、每次训练的动作、组数、次数、休息时间、预计训练时长以及每周各肌肉的训练量。
   • 训练动作数量根据训练时长和目标的休息周期动态决定，而非固定数量。
   • 相同请求始终返回相同计划，便于缓存。

3. 智能动作替代

   • 通过GET /v1/exercises/{id}/alternatives?equipment=dumbbell接口，在器械不可用时提供替代动作。
   • 替代动作的排序依据为共享主要肌肉、动作机制（复合或孤立）和发力方向，并返回选择原因。

4. 肌肉映射图

   • 通过GET /v1/exercises/{id}/muscle-map接口，返回正反面SVG人体图，用不同颜色高亮主要和次要肌肉。
   • 支持自定义配色、任意尺寸和深色主题，所有高亮形状带有data-muscle标签。
   • 图为按请求实时生成的矢量图，无需下载或托管。

---

数据与许可

• 数据来源： free-exercise-db，发布于Unlicense（公有领域），无需署名。
• 图片资源： 图片URL指向固定提交版本的CDN，确保稳定且无限流。
• 数据校验： 每次构建均与原始上游数据集逐字段校验，确保返回内容与源数据一致。

---

其他特点

• 错误处理： 未知过滤值返回400状态码，并附带允许的值列表，而不是静默返回空结果。
• 常见缩写支持： 接受如abs、quads、pecs、delts、lats、bodyweight等缩写。
• 响应优化： 通过?images=false&instructions=false可精简响应，仅返回动作名称。
• 随机动作接口： /v1/exercises/random?seed=monday支持可重复随机；无种子时不缓存。
• 过滤器和统计接口： /v1/filters返回所有允许的值，/v1/stats可预先查询过滤结果数量。