# HnieOJ ## API Docs - 用户模块 > 公开接口 [登录接口](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418652432e0.md): - 使用 uid 作为登录凭证 - 用户模块 > 公开接口 [注册用户](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418654166e0.md): - 用户模块 > STUDENT 及以上可访问 [获取当前登录用户信息](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418653234e0.md): 需携带 Token - 用户模块 > STUDENT 及以上可访问 [获取用户列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418692947e0.md): 通用展示，不包含邮箱/手机号等敏感字段 - 用户模块 > STUDENT 及以上可访问 [ 根据 uid 获取用户信息 ](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693067e0.md): 通用展示，不包含邮箱/手机号等敏感字段 - 用户模块 > STUDENT 及以上可访问 [ 检查用户是否存在](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420622013e0.md): - 用户模块 > ADMIN 及以上可访问 [ 创建用户](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418654618e0.md): `initialPassword` 为后端补充字段，仅在未传 password 时返回，若传 password 则`initialPassword` 为null - 用户模块 > ADMIN 及以上可访问 [更新用户信息](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418655261e0.md): - 用户模块 > ADMIN 及以上可访问 [修改用户密码](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418655314e0.md): - 用户模块 > ADMIN 及以上可访问 [删除用户](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418655453e0.md): - 用户模块 > ADMIN 及以上可访问 [批量禁用用户](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418655507e0.md): - 用户模块 > ADMIN 及以上可访问 [批量激活用户](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418655533e0.md): - 用户模块 > ADMIN 及以上可访问 [批量删除用户](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418655588e0.md): - 用户模块 > ADMIN 及以上可访问 [获取权限用户列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418655940e0.md): 仅包含STUDENT以上的权限 - 用户模块 > ADMIN 及以上可访问 [搜索用户](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418656051e0.md): 用于后台管理页面 - 用户模块 > ADMIN 及以上可访问 [批量赋予权限](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418657780e0.md): - 用户模块 > ADMIN 及以上可访问 [更新用户权限](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418658069e0.md): - 用户模块 > ADMIN 及以上可访问 [撤销权限](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418658272e0.md): 回归STUDENT - 用户模块 > ADMIN 及以上可访问 [批量撤销权限](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418658316e0.md): - 用户模块 > ADMIN 及以上可访问 [获取申请注册用户列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693356e0.md): - 用户模块 > ADMIN 及以上可访问 [通过注册申请](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693447e0.md): - 用户模块 > ADMIN 及以上可访问 [驳回注册申请](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693551e0.md): - 用户模块 > ADMIN 及以上可访问 [ 批量通过注册申请](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693577e0.md): - 用户模块 > ADMIN 及以上可访问 [ 下载用户导入模板](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/471047622e0.md): `.xlsx` 文件流 - 用户成就模块 > STUDENT 及以上可访问 [获取用户成就列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693609e0.md): - 用户成就模块 > STUDENT 及以上可访问 [ 提交成就认证申请](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693947e0.md): - 用户成就模块 > ADMIN 及以上可访问 [添加用户成就](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693720e0.md): TODO：将 title 设则为必填项，删除使用 content 截断生成的方式 - 用户成就模块 > ADMIN 及以上可访问 [ 删除用户成就](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693910e0.md): - 用户成就模块 > ADMIN 及以上可访问 [获取用户成就申请列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418732512e0.md): - 用户成就模块 > ADMIN 及以上可访问 [通过成就认证申请](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693951e0.md): - 用户成就模块 > ADMIN 及以上可访问 [ 驳回成就认证申请](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418693955e0.md): - 基础数据模块 > STUDENT 及以上可访问 [获取年级列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418732533e0.md): - 基础数据模块 > STUDENT 及以上可访问 [获取学院列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418732528e0.md): - 基础数据模块 > STUDENT 及以上可访问 [获取班级列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418733214e0.md): - 基础数据模块 > STUDENT 及以上可访问 [获取班级老师列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418733278e0.md): - 基础数据模块 > STUDENT 及以上可访问 [获取班级助教列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418733567e0.md): - 题目模块 > STUDENT 及以上可访问 [ 获取题目列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418771972e0.md): - 题目模块 > STUDENT 及以上可访问 [ 获取题目详情](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418776331e0.md): - 题目模块 > STUDENT 及以上可访问 [检查题目是否存在](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420930037e0.md): - 题目模块 > TEACHER 及以上可访问 [ 下载全部测试数据](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469586957e0.md): - 题目模块 > TEACHER 及以上可访问 [下载指定测试点](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469586988e0.md): - 题目模块 > ADMIN 及以上可访问 [获取题目列表 (Admin)](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418776882e0.md): TODO：补全字段 - 题目模块 > ADMIN 及以上可访问 [添加題目](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418777259e0.md): - 题目模块 > ADMIN 及以上可访问 [编辑题目](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418778963e0.md): - 题目模块 > ADMIN 及以上可访问 [ 删除题目](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418779002e0.md): - 题目模块 > ADMIN 及以上可访问 [切换题目公开状态](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418779053e0.md): - 题目模块 > ADMIN 及以上可访问 [上传或更新测试数据](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469576993e0.md): ZIP 内部条目必须是顶层文件名，仅保留 `.in/.out`，且必须成对出现。上传前会限制压缩包大小、解压后总大小和文件数量。上传成功后覆盖 `/data/oj/problems/{id}/testdata/` 并自增 `problem.data_version` - 题目模块 > ADMIN 及以上可访问 [上传题面图片](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469577337e0.md): 后端将题目图片保存至 /data/oj/problems/{id}/images/，对外暴露 /oj/images/{problemId}/{filename}，由 Nginx 映射回磁盘目录，并随机重命名文件以隐藏原始信息、防止重名冲突。 - 题目模块 > ADMIN 及以上可访问 [删除题面图片](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469586482e0.md): 删除时的 `filename` 使用上传接口返回 URL 的最后一段，例如 `5531C044CAA748307A6A46D2F079C1CF.jpg` - 提交模块 > STUDENT 及以上可访问 [提交代码](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/455980104e0.md): - 提交模块 > STUDENT 及以上可访问 [ 获取提交记录列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/455980279e0.md): STUDENT 默认仅查询本人提交；ADMIN/ROOT 可查询全站，并可使用 `uid` 过滤 - 提交模块 > STUDENT 及以上可访问 [ 获取提交记录详情](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/455980693e0.md): 提交代码仅提交者本人或管理员可见。 - 提交模块 > STUDENT 及以上可访问 [获取提交测试点结果](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/455980935e0.md): 提交者本人可查询测试点状态、耗时、内存和分数；`inputData/outputData/userOutput` 当前仅管理员可见，普通用户返回 `null`。 - 提交模块 > TEACHER 及以上可访问 [ 重判单个提交](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469950802e0.md): - 提交模块 > TEACHER 及以上可访问 [ 查询判题任务 outbox](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469953760e0.md): - 提交模块 > TEACHER 及以上可访问 [手动重试判题任务 outbox](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469962153e0.md): - 提交模块 > TEACHER 及以上可访问 [ 创建批量重判任务](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469963138e0.md): - 提交模块 > TEACHER 及以上可访问 [ 查询批量重判任务](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469971331e0.md): - 提交模块 [STOMP WebSocket](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/3830577w0.md): - 判题模块 > 判题节点认证接口 [ 临时判题节点兑换短期 Token](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/456682980e0.md): - 判题模块 > ADMIN 及以上可访问 [创建临时判题节点授权码](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/456681347e0.md): - 判题模块 > ADMIN 及以上可访问 [ 轮换正式判题节点长期 Token](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469631784e0.md): - 判题模块 > ADMIN 及以上可访问 [查询判题节点短期 Token](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469694749e0.md): - 判题模块 > ADMIN 及以上可访问 [吊销判题节点短期 Token](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469695120e0.md): - 判题模块 > ADMIN 及以上可访问 [查询判题节点状态](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/469975549e0.md): - 比赛模块 > STUDENT 及以上可访问 [获取比赛列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418890336e0.md): - 比赛模块 > STUDENT 及以上可访问 [ 获取比赛详情](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418890341e0.md): - 比赛模块 > STUDENT 及以上可访问 [检查比赛 ID 有效性](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421210653e0.md): - 比赛模块 > ADMIN 及以上可访问 [获取比赛列表 (Admin)](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420519820e0.md): - 比赛模块 > ADMIN 及以上可访问 [添加比赛](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420657232e0.md): - 比赛模块 > ADMIN 及以上可访问 [编辑比赛](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420657388e0.md): - 比赛模块 > ADMIN 及以上可访问 [删除比赛](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420657521e0.md): - 比赛模块 > ADMIN 及以上可访问 [ 切换比赛状态](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420657530e0.md): - 比赛模块 > ADMIN 及以上可访问 [ 获取比赛详情 (Admin)](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420657630e0.md): - 比赛模块 > ADMIN 及以上可访问 [ 获取比赛队伍列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420658430e0.md): - 比赛模块 > ADMIN 及以上可访问 [ 添加比赛队伍](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420658841e0.md): - 比赛模块 > ADMIN 及以上可访问 [更新比赛队伍](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420658879e0.md): - 比赛模块 > ADMIN 及以上可访问 [ 删除比赛队伍](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420658880e0.md): - 比赛模块 > ADMIN 及以上可访问 [ 批量删除比赛队伍](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420658941e0.md): - 题单模块 > STUDENT 及以上可访问 [获取题单列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418915242e0.md): - 题单模块 > STUDENT 及以上可访问 [获取题单详情](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418916728e0.md): - 题单模块 > STUDENT 及以上可访问 [ 获取题单题目列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418916740e0.md): - 题单模块 > ADMIN 及以上可访问 [获取题单列表 (Admin)](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420853414e0.md): - 题单模块 > ADMIN 及以上可访问 [ 添加题单](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420863687e0.md): - 题单模块 > ADMIN 及以上可访问 [ 编辑题单](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420869448e0.md): - 题单模块 > ADMIN 及以上可访问 [删除题单](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420872843e0.md): - 题单模块 > ADMIN 及以上可访问 [ 切换题单状态](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/420874520e0.md): - 作业模块 > STUDENT 及以上可访问 [获取作业列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418916832e0.md): - 作业模块 > STUDENT 及以上可访问 [获取作业详情](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418916872e0.md): - 作业模块 > ADMIN 及以上可访问 [ 获取作业列表 (Admin)](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421065542e0.md): - 作业模块 > ADMIN 及以上可访问 [添加作业](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421124284e0.md): - 作业模块 > ADMIN 及以上可访问 [编辑作业](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421124700e0.md): - 作业模块 > ADMIN 及以上可访问 [删除作业](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421124742e0.md): - 作业模块 > ADMIN 及以上可访问 [切换作业状态](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421125103e0.md): - 作业模块 > ADMIN 及以上可访问 [获取作业详情 (Admin)](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421125145e0.md): - 讨论模块 > STUDENT 及以上可访问 [获取讨论列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418916922e0.md): - 讨论模块 > STUDENT 及以上可访问 [获取讨论详情](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418917135e0.md): - 讨论模块 > STUDENT 及以上可访问 [点赞 / 点踩](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418917156e0.md): - 讨论模块 > STUDENT 及以上可访问 [新建讨论](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418938850e0.md): - 讨论模块 > STUDENT 及以上可访问 [发布回答](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418939012e0.md): - 讨论模块 > STUDENT 及以上可访问 [发布评论](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418939081e0.md): - 讨论模块 > STUDENT 及以上可访问 [ 获取相关讨论](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/418939208e0.md): - 讨论模块 > ADMIN 及以上可访问 [获取讨论列表 (Admin)](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421142733e0.md): - 讨论模块 > ADMIN 及以上可访问 [ 编辑讨论](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421143087e0.md): - 讨论模块 > ADMIN 及以上可访问 [删除讨论](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421143158e0.md): - 公告/新闻模块 > STUDENT 及以上可访问 [获取公告列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/419120106e0.md): - 公告/新闻模块 > STUDENT 及以上可访问 [获取公告详情](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/419120714e0.md): - 公告/新闻模块 > ADMIN 及以上可访问 [获取公告列表（Admin）](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/419126003e0.md): - 公告/新闻模块 > ADMIN 及以上可访问 [创建公告](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/419127223e0.md): - 公告/新闻模块 > ADMIN 及以上可访问 [更新公告](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/419131093e0.md): - 公告/新闻模块 > ADMIN 及以上可访问 [删除公告](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/419132604e0.md): - 公告/新闻模块 > ADMIN 及以上可访问 [更新公告上下线状态](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/419133965e0.md): - 系统模块 > 公开接口 [ 获取系统公开信息](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421209152e0.md): - 系统模块 > 公开接口 [获取系统时间](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421209256e0.md): - 系统模块 > ADMIN 及以上可访问 [获取系统配置](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421209987e0.md): - 系统模块 > ADMIN 及以上可访问 [更新系统配置](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421210089e0.md): - 系统模块 > ADMIN 及以上可访问 [获取远程评测账号列表](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421210112e0.md): - 系统模块 > ADMIN 及以上可访问 [重置 Judger Token](https://s.apifox.cn/91edc2c6-6918-4179-9852-9ec3742377c8/421210118e0.md):