更新会员规律运动提醒API

API概述

该API用于更新会员的规律运动提醒频率和提醒时间设置。通过这个API，可以设置会员接收提醒的频率（每日、每周、每月或不提醒）以及具体的提醒时间。

请求信息

POST /gym/member/update_exercise_reminder

请求参数

参数名 类型 必填 描述
member_id Integer 否 会员ID，如果不提供则使用当前登录用户关联的会员
exercise_reminder_frequency String 否 规律运动提醒频率，可选值：daily(每日)、weekly(每周)、monthly(每月)、none(不提醒)
exercise_reminder_time Float 否 提醒时间，格式为浮点数，如19.75表示19:45，取值范围0-24
access_token String 是 访问令牌，用于API调用验证

注意： 虽然 member_id、exercise_reminder_frequency 和 exercise_reminder_time 都是可选参数，但至少需要提供其中一个参数才能进行更新操作。

请求示例

POST /gym/member/update_exercise_reminder
Content-Type: application/json
Authorization: Bearer your_access_token

{
  "exercise_reminder_frequency": "daily",
  "exercise_reminder_time": 19.75
}

响应信息

响应参数

参数名 类型 描述
member_id Integer 会员ID
exercise_reminder_frequency String 更新后的规律运动提醒频率
exercise_reminder_time Float 更新后的提醒时间
message String 操作结果描述

成功响应示例

{
  "error": 0,
  "data": {
    "member_id": 123,
    "exercise_reminder_frequency": "daily",
    "exercise_reminder_time": 19.75,
    "message": "更新成功"
  }
}

错误响应示例

{
  "error": 400,
  "error_descrip": "无效的提醒频率",
  "error_type": "Invalid frequency"
}

错误码说明

错误码 错误类型 错误描述 说明
400 Member not found 未找到会员信息 指定的会员ID不存在，或当前登录用户没有关联的会员
400 Invalid frequency 无效的提醒频率 提供的exercise_reminder_frequency参数值不在允许的范围内
400 Invalid time 提醒时间必须在0-24之间 提供的exercise_reminder_time参数值超出了有效范围
400 Invalid time format 提醒时间格式无效 提供的exercise_reminder_time参数不是有效的浮点数
400 No data to update 没有提供需要更新的数据 请求中没有提供任何有效的参数
500 Update failed 更新失败 服务器内部错误导致更新操作失败

注意事项

使用场景

该API主要用于以下场景：

前端调用示例

// 使用fetch API调用
fetch('/gym/member/update_exercise_reminder', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ' + accessToken
  },
  body: JSON.stringify({
    exercise_reminder_frequency: 'daily',
    exercise_reminder_time: 19.75
  })
})
.then(response => response.json())
.then(data => {
  console.log('更新成功:', data);
})
.catch(error => {
  console.error('错误:', error);
});