标记待办活动为已完成API

API概述

该API用于将一个或多个待办活动标记为已完成。支持批量操作，可以一次性标记多个待办活动。

请求信息

POST /gym/activity/mark_done

请求参数

参数名 类型 必填 描述
activity_ids Array/Integer/String 是 待办活动ID或ID数组。可以是单个ID、ID数组或JSON字符串形式的ID数组
access_token String 是 访问令牌，用于API调用验证

请求示例

单个活动ID

POST /gym/activity/mark_done
Content-Type: application/json
Authorization: Bearer your_access_token

{
  "activity_ids": 123
}

多个活动ID

POST /gym/activity/mark_done
Content-Type: application/json
Authorization: Bearer your_access_token

{
  "activity_ids": [123, 124, 125]
}

响应信息

响应参数

参数名 类型 描述
message String 操作结果摘要，包含处理的活动数量、成功数量和失败数量
data Object 操作结果详情
data.success Array 成功标记为已完成的活动ID列表
data.failed Array 标记失败的活动信息列表，每项包含ID和失败原因

成功响应示例

{
  "error": 0,
  "data": {
    "message": "处理了 3 个活动，2 个成功，1 个失败",
    "data": {
      "success": [123, 124],
      "failed": [
        {
          "id": 125,
          "reason": "Activity not found"
        }
      ]
    }
  }
}

错误响应示例

{
  "error": 400,
  "error_descrip": "缺少活动ID参数",
  "error_type": "Missing activity_ids"
}

错误码说明

错误码 错误类型 错误描述 说明
400 Missing activity_ids 缺少活动ID参数 请求中未提供activity_ids参数
400 Invalid activity_ids 活动ID格式无效 提供的activity_ids参数格式不正确

注意事项

使用场景

该API主要用于以下场景：