健身教练学员数据统计API文档

学员数据统计API

接口信息

• 认证: 需要认证，使用access_token
• 描述: 获取教练的学员数据统计，包括性别分布、年龄分布和健身类型分布

请求参数

响应数据

成功响应(200):

{
  "total_members": 28,
  "gender_distribution": {
    "data": {
      "女": 64.3,
      "男": 25.0,
      "未知": 10.7
    },
    "details": [
      {
        "性别": "女",
        "学员数": 18,
        "占比": "64.3%"
      },
      {
        "性别": "男",
        "学员数": 7,
        "占比": "25.0%"
      },
      {
        "性别": "未知",
        "学员数": 3,
        "占比": "10.7%"
      }
    ]
  },
  "age_distribution": {
    "data": {
      "20岁以下": 3.6,
      "20-30岁": 21.4,
      "30-40岁": 46.4,
      "40-50岁": 21.4,
      "50岁以上": 3.6,
      "未知": 3.6
    },
    "details": [
      {
        "年龄": "20岁以下",
        "学员数": 1,
        "占比": "3.6%"
      },
      {
        "年龄": "20-30岁",
        "学员数": 6,
        "占比": "21.4%"
      },
      {
        "年龄": "30-40岁",
        "学员数": 13,
        "占比": "46.4%"
      },
      {
        "年龄": "40-50岁",
        "学员数": 6,
        "占比": "21.4%"
      },
      {
        "年龄": "50岁以上",
        "学员数": 1,
        "占比": "3.6%"
      },
      {
        "年龄": "未知",
        "学员数": 1,
        "占比": "3.6%"
      }
    ]
  },
  "fitness_type_distribution": {
    "data": {
      "减肥": 28.6,
      "增肌塑形": 57.1,
      "提升心肺和体能": 10.7,
      "改善疾病和疼痛": 3.6
    },
    "details": [
      {
        "健身类型": "减肥",
        "学员数": 8,
        "占比": "28.6%"
      },
      {
        "健身类型": "增肌塑形",
        "学员数": 16,
        "占比": "57.1%"
      },
      {
        "健身类型": "提升心肺和体能",
        "学员数": 3,
        "占比": "10.7%"
      },
      {
        "健身类型": "改善疾病和疼痛",
        "学员数": 1,
        "占比": "3.6%"
      }
    ]
  }
}

错误响应:

{
  "error": "User not found",
  "error_descrip": "未找到用户信息"
}

{
  "error": "Trainer not found",
  "error_descrip": "未找到教练信息"
}

{
  "error": "No students found",
  "error_descrip": "未找到学员信息"
}

数据字段说明

total_members (总学员数)

• 教练名下的总学员数量

gender_distribution (性别分布)

• data: 性别分布百分比数据，用于图表展示
• details: 性别分布详细数据，包含每个性别的学员数量和占比

age_distribution (年龄分布)

• data: 年龄分布百分比数据，用于图表展示
• details: 年龄分布详细数据，包含每个年龄段的学员数量和占比

fitness_type_distribution (健身类型分布)

• data: 健身类型分布百分比数据，用于图表展示
• details: 健身类型分布详细数据，包含每种健身类型的学员数量和占比

健身类型判断逻辑

使用示例

请求示例

GET /gym/member/my_member_students_data?access_token=abc123

前端展示示例

该API返回的数据可用于生成类似以下的展示效果:

1. 性别分布图表:
   • 使用环形图展示学员性别分布
   • 显示女性、男性和未知性别的占比
2. 年龄分布图表:
   • 使用环形图展示学员年龄分布
   • 显示各年龄段学员的占比
3. 健身类型分布图表:
   • 使用环形图展示学员健身类型分布
   • 显示各健身类型学员的占比
4. 数据详情表格:
   • 展示每个分类的详细数据，包括具体数量和百分比