上传一张图片并进行处理,返回处理结果。

• URL: /api/upload
• 方法: POST
• Content-Type: multipart/form-data

• 状态码: 200 OK
• Content-Type: application/json

{
 "result_map": [...],
 "path_map": [...],
 "middle_wall": [...],
 "picture": [...]
}

• 状态码: 400 Bad Request
• Content-Type: application/json

{
 "error": "错误描述"
}

可能的错误描述:

• "No file part": 请求中没有文件部分
• "No selected file": 没有选择文件
• "Size parameter is missing": 缺少尺寸参数
• "Invalid size parameter": 无效的尺寸参数格式

{
 "result_map": [...],
 "path_map": [...],
 "middle_wall": [...],
 "picture": [...]
}

{
 "error": "Invalid size parameter"
}

这个API端点用于生成地图数据。它接受一个序列号和可选的地图大小参数,然后返回生成的地图数据,包括结果地图、路径地图和中间墙壁信息。

• URL: /api/getMap
• 方法: POST
• 内容类型: application/json

{
 "size": "25"
}

copy{
 "result_map": [[...], [...], ...],
 "path_map": [[...], [...], ...],
 "middle_wall": [[...], [...], ...]
}

获取指定关卡和难度(可选)的排行榜数据。

• 方法: POST
• URL: /leaderboard
• 内容类型: application/json

copy{
 "level_id": integer,
 "difficulty": integer (可选)
}

• 状态码: 200 OK
• 内容类型: application/json

copy{
 "关卡": integer,
 "难度": integer 或 null,
 "排行榜": [
 {
 "排名": integer,
 "用户名": string,
 "完成时间": float,
 "难度": integer,
 "时间戳": string
 },
 ...
 ]
}

当指定的关卡和难度组合没有排行榜数据时,API 仍会返回 200 状态码,但会包含一个说明性消息:

copy{
 "关卡": integer,
 "难度": integer 或 null,
 "消息": string,
 "排行榜": []
}

• 状态码: 400 Bad Request
• 内容类型: application/json

copy{
 "错误": string
}

当请求中缺少必要的 level_id 时,将返回此错误响应。

注册新用户。

• URL: /api/register

• 方法: POST

• 请求体

  :

  {
   "username": "string",
   "password": "string"
  }
  

• 成功响应

  :

  • 状态码: 201

  • 响应体

    :

    copy{
     "message": "User registered successfully"
    }
    

• 错误响应

  :

  • 状态码: 400

  • 响应体

    :

    copy{
     "message": "Username and password are required"
    }
    

  或

  copy{
   "message": "Username already exists"
  }
  

用户登录并获取访问令牌。

• URL: /api/login

• 方法: POST

• 请求体

  :

  copy{
   "username": "string",
   "password": "string"
  }
  

• 成功响应

  :

  • 状态码: 200

  • 响应体

    :

    copy{
     "access_token": "string"
    }
    

• 错误响应

  :

  • 状态码: 400

  • 响应体

    :

    copy{
     "message": "Username and password are required"
    }
    

  或

  • 状态码: 401

  • 响应体

    :

    copy{
     "message": "Invalid username or password"
    }
    

获取当前用户的所有游戏记录。

• URL: /api/protected
• 方法: GET
• 认证: 需要JWT令牌

• 状态码: 200 OK

• 内容

  :

  {
   "用户名": "string",
   "游戏记录": [
   {
   "关卡": "string",
   "完成时间": "number",
   "得分": "number",
   "时间戳": "string (ISO 8601 格式)"
   }
   ]
  }
  

• 状态码: 200 OK

• 内容

  :

  {
   "用户名": "string",
   "游戏记录": [],
   "消息": "该用户还没有游戏记录"
  }
  

• 状态码: 404 Not Found

• 内容

  :

  {
   "错误": "用户不存在"
  }
  

获取当前用户在特定关卡的所有游戏记录。

• URL: /api/level_record

• 方法: POST

• 认证: 需要JWT令牌

• 请求体

  :

  {
   "level_id": "string"
  }
  

• 状态码: 200 OK

• 内容

  :

  {
   "用户名": "string",
   "关卡": "string",
   "游戏记录": [
   {
   "完成时间": "number",
   "得分": "number",
   "时间戳": "string (ISO 8601 格式)"
   }
   ]
  }
  

• 状态码: 200 OK

• 内容

  :

  copy{
   "用户名": "string",
   "关卡": "string",
   "游戏记录": [],
   "消息": "该用户在关卡 {level_id} 还没有游戏记录"
  }
  

• 状态码: 400 Bad Request

• 内容:

  copy{
   "错误": "缺少关卡ID"
  }
  

• 状态码: 404 Not Found

• 内容:

  copy{
   "错误": "用户不存在"
  }
  

• URL: /api/add_record
• 方法: POST
• 需要认证: 是 (JWT Token)

{
 "level_id": 整数,
 "completion_time": 浮点数,
 "score": 整数,
 "difficulty": 整数
}

• level_id: 必需。游戏关卡的唯一标识符。
• completion_time: 必需。完成关卡所用的时间(以秒为单位)。
• score: 必需。在关卡中获得的分数。
• difficulty_coefficient: 必需。关卡的难度系数,用于分类排行榜。

• 状态码: 201 Created
• 内容类型: application/json

copy{
 "消息": "游戏记录添加成功,排行榜已更新",
 "记录": {
 "用户名": 字符串,
 "关卡": 整数,
 "完成时间": 浮点数,
 "得分": 整数,
 "难度系数": 浮点数,
 "时间戳": 字符串 (ISO 8601 格式)
 }
}

• 状态码: 400 Bad Request
  • 原因: 请求体缺少必要的信息

{
 "错误": "缺少必要的信息"
}

• 状态码: 404 Not Found
  • 原因: 用户不存在

{
 "错误": "用户不存在"
}

GET /api/check_session

此API用于检查当前用户的会话是否有效。它验证JWT令牌中的会话ID是否与数据库中存储的用户会话ID匹配。

需要有效的JWT令牌。

• Authorization: Bearer <JWT_TOKEN>

无

状态码: 200 OK

{
 "message": "会话有效",
 "valid": true
}