Skip to content

Latest commit

 

History

History
157 lines (123 loc) · 4.74 KB

readme.md

File metadata and controls

157 lines (123 loc) · 4.74 KB

瀚海工艺-Vastsea | 后端API使用指南

  • API遵守RESTful
  • 返回的内容在body里面

用户模块

API列表

  • code微软登录
  • access_token微软登录
  • 瀚海token登录
  • 刷新Minecraft信息
  • 删除账户

code微软登录

  • 请求:GET /users?code=[获取的code]&token=[是否需要服务器token]
  • 请求说明:
    • code(参考 https://mccteam.github.io/redirect.html 中的获取方式)
  • 返回:
    • 如果成功登录并获取到用户信息,则返回200和用户信息
    • 如果缺少参数,则返回400
    • 如果用户未拥有Minecraft正版账号,则返回401
    • 如遇其他问题,则返回500
  • 请求实例:GET /users?code=M.R3_BAY.ae4a08be-40bc-d750-9fb2-15e0c808c543
  • 返回实例:
    { "_id": "544e8a58c8054879b01ad596d8175dc4", "display_name": "zrll_", "enabled": true, "group": ["default"], "bind_qq": null }

access_token微软登录

  • 请求:GET /users?atoken=[access_token]
  • 返回:
    • 如果成功登录并获取到用户信息,则返回200和用户信息
    • 如果缺少参数,则返回400
    • 如果用户未拥有Minecraft正版账号,则返回401
    • 如遇其他问题,则返回500
  • 请求实例:POST /users?atoken=******
  • 返回实例:
    { "_id": "544e8a58c8054879b01ad596d8175dc4", "display_name": "zrll_", "enabled": true, "group": ["default"], "bind_qq": null }

瀚海token登录

  • 请求:GET /users?htoken=[token]
  • 返回:
    • 如果成功登录并获取到用户信息,则返回200和用户信息
    • 如果缺少参数,则返回400
    • 如果用户未拥有mc,则返回401
    • 如遇其他问题,则返回500
  • 请求实例:POST /users?htoken=******
  • 返回实例:
    { "_id": "544e8a58c8054879b01ad596d8175dc4", "display_name": "zrll_", "enabled": true, "group": ["default"], "bind_qq": null }

新闻模块

新闻id为正整数(可能不连续) 带*的需要管理员权限

API列表

  • 获取新闻列表
  • 获取新闻详细信息
  • *上传新闻

获取新闻列表

  • 返回开始id及其之后n-1个新闻的信息
  • 请求:GET /news?start=[开始nid]&n=[获取个数]

获取新闻详细信息

  • 请求:GET /news/[id]
  • 返回md文件内容

上传新闻

  • 请求:POST /news
  • 请求body格式:{"token": "瀚海token", "body": "新闻具体内容", "info": {"title": "新闻标题", "description": "新闻简介"}}
  • 返回:创建成功200,鉴权失败401,创建失败500
  • 请求body示例{"token": "token", "body": "this is the first", "info": {"title": "111", "description": "first"}}

文件模块

API列表

  • 检查最新版本
  • 请求下载文件

问卷模块

本模块中所有标记-的需要管理员权限
所有标记*的需要本人或管理权限

API列表

  • -判卷
  • -维护某一问卷题目与答案
  • *检查某一用户答卷进度
  • *访问某一特定答卷
  • *请求开始问卷或重新答题
  • *提交答案

外部API

本模块所有api均需要api key

API列表

  • 封禁用户
  • 绑定QQ
  • 获取QQ
  • 获取幸运值

封禁用户

  • 请求:PUT /users?uuid=[uuid]&qq=[qq]&reason=[reason]&key=[key]
  • reason为选填
  • qq与uuid仅需提供一个
  • 返回:
    • 如果成功封禁,则返回200
    • 如果缺少参数,则返回400
    • 如果key错误,则返回401
    • 如遇其他问题,则返回500
  • 请求实例:PUT /users?uuid=544e8a58c8054879b01ad596d8175dc4&reason=QAQ&key=q2XS6AXzNNMK2ksMDTf7bqxypBEM3q9CQq2WWE4KLOU~

绑定QQ

  • 请求:PATCH /users?uuid=[uuid]&qq=[qq]&key=[key]
  • 返回:
    • 如果成功绑定,则返回200
    • 如果缺少参数,则返回400
    • 如果key错误,则返回401
    • 如遇其他问题,则返回500
  • 请求实例:PATCH /users?uuid=544e8a58c8054879b01ad596d8175dc4&qq=2406324685&key=q2XS6AXzNNMK2ksMDTf7bqxypBEM3q9CQq2WWE4KLOU~

获取QQ

  • 请求:GET /user/qq?uuid=[uuid]&key=[key]
  • 返回:
    • 如果成功获取,返回200
    • 如果缺少参数,返回400
    • 如果key错误,返回500
    • 如果用户不存在,返回500
    • 如果发生其他错误,返回500
  • 请求实例:GET /user/qq?uuid=544e8a58c8054879b01ad596d8175dc4&key=q2XS6AXzNNMK2ksMDTf7bqxypBEM3q9CQq2WWE4KLOU~

获取幸运值

  • 请求:GET /user/luck?uuid=[uuid]&key=[key]
  • 返回:
    • 如果成功获取,返回200
    • 如果缺少参数,返回400
    • 如果key错误,返回500
    • 如果用户未绑定,返回500
    • 如果发生其他错误,返回500
  • 请求实例:GET /user/qq?uuid=544e8a58c8054879b01ad596d8175dc4&key=q2XS6AXzNNMK2ksMDTf7bqxypBEM3q9CQq2WWE4KLOU~