# Mimo Blog ## API Docs - 公告管理 [公告列表](https://apidoc.xunrua.top/477578299e0.md): 获取所有公告（含未激活，非分页）。需管理员权限。 - 公告管理 [创建公告](https://apidoc.xunrua.top/477578300e0.md): 创建公告。需管理员权限。 - 公告管理 [删除公告](https://apidoc.xunrua.top/477578301e0.md): 删除公告。需管理员权限。 - 公告管理 [公告详情](https://apidoc.xunrua.top/477578302e0.md): 按 ID 获取公告。需管理员权限。 - 公告管理 [更新公告](https://apidoc.xunrua.top/477578303e0.md): 更新公告。需管理员权限。 - 评论管理 [所有评论列表](https://apidoc.xunrua.top/477578304e0.md): 管理员查看所有评论，可按 status 过滤（返回 AdminCommentDTO）。需管理员权限。 - 评论管理 [批量更新评论状态](https://apidoc.xunrua.top/477578305e0.md): 批量修改评论状态。需管理员权限。 - 评论管理 [待审核评论列表](https://apidoc.xunrua.top/477578306e0.md): 获取 pending 状态评论（返回基础 CommentDTO）。需管理员权限。 - 评论管理 [待审核评论数量](https://apidoc.xunrua.top/477578307e0.md): 返回待审核评论数量。需管理员权限。 - 评论管理 [评论详情](https://apidoc.xunrua.top/477578308e0.md): 获取评论详情（AdminCommentDTO）。需管理员权限。 - 评论管理 [删除评论](https://apidoc.xunrua.top/477578309e0.md): 删除评论。需管理员权限。 - 评论管理 [审核通过](https://apidoc.xunrua.top/477578310e0.md): 将评论标记为 approved。需管理员权限。 - 评论管理 [标记垃圾](https://apidoc.xunrua.top/477578311e0.md): 将评论标记为 spam。需管理员权限。 - 表情管理 [删除表情](https://apidoc.xunrua.top/477578312e0.md): 删除单个表情。需管理员权限。 - 表情管理 [更新表情](https://apidoc.xunrua.top/477578313e0.md): 更新单个表情。需管理员权限。 - 表情管理 [所有分组（含未启用）](https://apidoc.xunrua.top/477578314e0.md): 获取所有表情分组（含禁用）。需管理员权限。 - 表情管理 [创建分组](https://apidoc.xunrua.top/477578315e0.md): 创建表情分组。需管理员权限。 - 表情管理 [批量启用/禁用分组](https://apidoc.xunrua.top/477578316e0.md): 批量修改分组启用状态。需管理员权限。 - 表情管理 [删除分组](https://apidoc.xunrua.top/477578317e0.md): 删除表情分组。需管理员权限。 - 表情管理 [更新分组](https://apidoc.xunrua.top/477578318e0.md): 更新表情分组。需管理员权限。 - 表情管理 [分组内表情列表](https://apidoc.xunrua.top/477578319e0.md): 获取指定分组内的表情。需管理员权限。 - 表情管理 [在分组内创建表情](https://apidoc.xunrua.top/477578320e0.md): 在指定分组内创建表情。需管理员权限。 - 表情管理 [上传表情图片](https://apidoc.xunrua.top/477578321e0.md): 上传表情图片（multipart/form-data，字段 file，≤10MB，扩展名白名单 jpg/jpeg/png/gif/webp/svg）。需管理员权限。 - 文件管理 [文件列表](https://apidoc.xunrua.top/477578322e0.md): 分页查询文件列表，可按 purpose 筛选。需管理员权限。 - 文件管理 [秒传检查](https://apidoc.xunrua.top/477578323e0.md): 按文件哈希检查是否已存在（秒传）。需管理员权限。 - 文件管理 [删除文件](https://apidoc.xunrua.top/477578324e0.md): 删除文件。需管理员权限。 - 操作日志 [操作日志列表](https://apidoc.xunrua.top/477578325e0.md): 分页查询操作日志。需管理员权限。 - 操作日志 [用户操作日志](https://apidoc.xunrua.top/477578326e0.md): 查询指定用户的操作日志。需管理员权限。 - 音乐管理 [歌单列表](https://apidoc.xunrua.top/477578327e0.md): 获取所有歌单（非分页）。需管理员权限。 - 音乐管理 [导入歌单](https://apidoc.xunrua.top/477578328e0.md): 通过链接导入歌单。需管理员权限。 - 音乐管理 [创建自定义歌单](https://apidoc.xunrua.top/477578329e0.md): 创建空的自定义歌单。需管理员权限。 - 音乐管理 [删除歌单](https://apidoc.xunrua.top/477578330e0.md): 删除歌单。需管理员权限。 - 音乐管理 [歌单详情](https://apidoc.xunrua.top/477578331e0.md): 按 ID 获取歌单。需管理员权限。 - 音乐管理 [更新歌单](https://apidoc.xunrua.top/477578332e0.md): 更新歌单标题/启用状态。需管理员权限。 - 音乐管理 [启用/禁用歌单](https://apidoc.xunrua.top/477578333e0.md): 切换歌单启用状态。需管理员权限。 - 音乐管理 [刷新歌单歌曲](https://apidoc.xunrua.top/477578334e0.md): 重新拉取歌单歌曲（仅导入歌单有效）。需管理员权限。 - 音乐管理 [添加歌曲到歌单](https://apidoc.xunrua.top/477578335e0.md): 向歌单添加一首歌曲。需管理员权限。 - 音乐管理 [移除歌曲](https://apidoc.xunrua.top/477578336e0.md): 从歌单移除指定位置的歌曲。需管理员权限。 - 音乐管理 [更新歌曲](https://apidoc.xunrua.top/477578337e0.md): 更新歌单中指定位置的歌曲信息。需管理员权限。 - 音乐管理 [更新播放器设置](https://apidoc.xunrua.top/477578338e0.md): 更新播放器版本。需管理员权限。 - 权限管理 [获取所有权限定义](https://apidoc.xunrua.top/477578339e0.md): 列出所有权限。需管理员权限。 - 权限管理 [创建权限](https://apidoc.xunrua.top/477578340e0.md): 创建权限。需超级管理员权限。 - 权限管理 [删除权限](https://apidoc.xunrua.top/477578341e0.md): 删除权限。需超级管理员权限。 - 权限管理 [更新权限](https://apidoc.xunrua.top/477578342e0.md): 更新权限。需超级管理员权限。 - 文章管理 [所有文章列表](https://apidoc.xunrua.top/477578343e0.md): 管理员查看所有文章（含草稿/归档），可按 status 过滤。需管理员权限。 - 文章管理 [创建文章](https://apidoc.xunrua.top/477578344e0.md): 创建文章，作者为当前登录用户。需管理员权限。 - 文章管理 [删除文章](https://apidoc.xunrua.top/477578345e0.md): 删除文章。需管理员权限。 - 文章管理 [文章详情](https://apidoc.xunrua.top/477578346e0.md): 按 ID 获取文章（后台）。需管理员权限。 - 文章管理 [更新文章](https://apidoc.xunrua.top/477578347e0.md): 更新文章内容。需管理员权限。 - 文章管理 [更新文章状态](https://apidoc.xunrua.top/477578348e0.md): 切换文章状态（draft/published/archived）。需管理员权限。 - 角色管理 [角色列表](https://apidoc.xunrua.top/477578349e0.md): 列出所有角色（含 user_count）。需管理员权限。 - 角色管理 [创建角色](https://apidoc.xunrua.top/477578350e0.md): 创建角色。需管理员权限。 - 角色管理 [删除角色](https://apidoc.xunrua.top/477578351e0.md): 删除角色。需管理员权限。 - 角色管理 [角色详情（含权限）](https://apidoc.xunrua.top/477578352e0.md): 获取角色详情及其权限列表。需管理员权限。 - 角色管理 [更新角色](https://apidoc.xunrua.top/477578353e0.md): 更新角色信息。需管理员权限。 - 角色管理 [设置角色权限](https://apidoc.xunrua.top/477578354e0.md): 设置角色的全部权限。需管理员权限。 - 站点设置 [获取站点设置](https://apidoc.xunrua.top/477578355e0.md): 获取全部站点设置（含敏感字段）。需管理员权限。 - 站点设置 [更新站点设置](https://apidoc.xunrua.top/477578356e0.md): 部分更新站点设置（全指针字段）。需管理员权限。 - 统计 [仪表盘总览统计](https://apidoc.xunrua.top/477578357e0.md): 返回仪表盘总览统计数据。需管理员权限。 - 统计 [浏览量趋势](https://apidoc.xunrua.top/477578358e0.md): 返回近 30 天每日与近 12 个月每月的浏览量趋势。需管理员权限。 - 用户管理 [用户列表](https://apidoc.xunrua.top/477578359e0.md): 分页查询用户列表，支持 role/is_active/keyword 筛选。需管理员权限。 - 用户管理 [创建用户](https://apidoc.xunrua.top/477578360e0.md): 管理员创建用户。需管理员权限。 - 用户管理 [批量修改用户角色](https://apidoc.xunrua.top/477578361e0.md): 批量修改用户角色。需管理员权限。 - 用户管理 [批量启用/禁用用户](https://apidoc.xunrua.top/477578362e0.md): 批量修改用户启用状态。需管理员权限。 - 用户管理 [删除用户](https://apidoc.xunrua.top/477578363e0.md): 删除用户。需管理员权限。 - 用户管理 [用户详情](https://apidoc.xunrua.top/477578364e0.md): 按 ID 获取用户详情。需管理员权限。 - 用户管理 [编辑用户](https://apidoc.xunrua.top/477578365e0.md): 部分更新用户信息（全指针字段）。需管理员权限。 - 用户管理 [修改用户角色](https://apidoc.xunrua.top/477578366e0.md): 修改单个用户角色。需管理员权限。 - 用户管理 [启用/禁用用户](https://apidoc.xunrua.top/477578367e0.md): 修改用户启用状态。需管理员权限。 - 公告 [生效公告列表](https://apidoc.xunrua.top/477578368e0.md): 获取当前生效的公告列表（非分页）。 - 认证 [获取 CSRF Token](https://apidoc.xunrua.top/477578369e0.md): 返回 CSRF Token，并设置 mimo_csrf cookie（JS 可读）。首次访问需先调用此端点拿到 cookie 才能 login。 - 认证 [忘记密码](https://apidoc.xunrua.top/477578370e0.md): 发送密码重置码到邮箱（邮箱不存在也返回成功，防探测）。受认证限流保护。 - 认证 [登录](https://apidoc.xunrua.top/477578371e0.md): 登录并下发 access/refresh/CSRF cookie（HttpOnly）。受认证限流保护。 - 认证 [登出](https://apidoc.xunrua.top/477578372e0.md): 登出并清除 access/refresh/CSRF cookie。 - 认证 [获取当前用户信息](https://apidoc.xunrua.top/477578373e0.md): - 认证 [修改密码](https://apidoc.xunrua.top/477578374e0.md): 修改密码并撤销 refresh token（需重新登录）。 - 认证 [更新个人资料](https://apidoc.xunrua.top/477578375e0.md): 更新头像、简介等个人资料。 - 认证 [刷新令牌](https://apidoc.xunrua.top/477578376e0.md): 用 refresh token 换取新的 access token（cookie 优先，body 回退）。受认证限流保护。 - 认证 [注册](https://apidoc.xunrua.top/477578377e0.md): 注册新用户并发送验证邮件。受认证限流保护。 - 认证 [重置密码](https://apidoc.xunrua.top/477578378e0.md): 用验证码重置密码。受认证限流保护。 - 认证 [邮箱验证](https://apidoc.xunrua.top/477578379e0.md): 校验邮箱验证码。受认证限流保护。 - 评论反应 [批量获取评论反应](https://apidoc.xunrua.top/477578380e0.md): 按评论 ID 批量查询反应（语义为查询，用 POST 因 body 含数组）。 - 评论反应 [获取评论反应](https://apidoc.xunrua.top/477578381e0.md): - 评论反应 [添加反应](https://apidoc.xunrua.top/477578382e0.md): 对评论添加表情反应。受评论限流保护（公开，匿名可调）。 - 评论反应 [删除反应](https://apidoc.xunrua.top/477578383e0.md): 删除自己添加的反应（需登录，防匿名删除他人反应）。 - 表情 [获取所有启用表情分组](https://apidoc.xunrua.top/477578384e0.md): 返回所有启用（is_enabled=true）的表情分组及其表情（非分页）。 - 表情 [按名称获取指定表情分组](https://apidoc.xunrua.top/477578385e0.md): - GitHub [GitHub 贡献数据](https://apidoc.xunrua.top/477578386e0.md): 获取 GitHub 贡献日历数据（绿色方块图）。Token 在后端管理，由站点设置里的 github_username 配置。 - GitHub [GitHub 仓库数据](https://apidoc.xunrua.top/477578387e0.md): 获取 GitHub 公开仓库列表。Token 在后端管理。 - 媒体 [媒体列表](https://apidoc.xunrua.top/477578388e0.md): 获取当前用户的媒体文件列表。需登录。 - 媒体 [批量删除媒体](https://apidoc.xunrua.top/477578389e0.md): 批量删除媒体文件。需登录。 - 媒体 [删除媒体](https://apidoc.xunrua.top/477578390e0.md): 删除媒体文件。需登录。 - 媒体 [媒体详情](https://apidoc.xunrua.top/477578391e0.md): - 媒体 [上传缩略图](https://apidoc.xunrua.top/477578392e0.md): 为媒体文件上传缩略图（multipart/form-data，字段 file，≤10MB，仅图片）。需登录。 - 音乐 [解析音乐链接返回嵌入信息](https://apidoc.xunrua.top/477578393e0.md): - 音乐 [获取歌词](https://apidoc.xunrua.top/477578394e0.md): - 音乐 [获取歌曲元数据（封面+歌词）](https://apidoc.xunrua.top/477578395e0.md): - 音乐 [解析歌单链接返回歌单信息](https://apidoc.xunrua.top/477578396e0.md): - 音乐 [获取所有启用歌单](https://apidoc.xunrua.top/477578397e0.md): - 音乐 [搜索歌曲](https://apidoc.xunrua.top/477578398e0.md): - 音乐 [获取播放器设置](https://apidoc.xunrua.top/477578399e0.md): - 音乐 [获取歌曲详情](https://apidoc.xunrua.top/477578400e0.md): - 文章 [已发布文章列表](https://apidoc.xunrua.top/477578401e0.md): 获取已发布文章列表（offset 分页）。前台 limit 上限为 50。可按 tag slug 过滤。 - 文章 [增加浏览次数](https://apidoc.xunrua.top/477578402e0.md): 记录一次文章浏览（IP 取自 X-Real-IP / X-Forwarded-For / RemoteAddr）。返回 204 无响应体。 - 文章 [按 slug 获取文章](https://apidoc.xunrua.top/477578403e0.md): - 评论 [文章已审核评论列表](https://apidoc.xunrua.top/477578404e0.md): - 评论 [提交评论](https://apidoc.xunrua.top/477578405e0.md): 提交评论（默认 pending，待审核）。受评论限流保护。 - 项目 [项目列表](https://apidoc.xunrua.top/477578406e0.md): 获取项目列表（非分页，返回全部）。 - 项目 [项目详情](https://apidoc.xunrua.top/477578407e0.md): - 站点配置 [获取公开站点配置](https://apidoc.xunrua.top/477578408e0.md): 返回站点公开配置（不含 github_token 等敏感字段）。 - 标签 [标签列表](https://apidoc.xunrua.top/477578409e0.md): - 标签 [创建标签](https://apidoc.xunrua.top/477578410e0.md): 需管理员权限。 - 标签 [删除标签](https://apidoc.xunrua.top/477578411e0.md): 需管理员权限。 - 分片上传 [初始化上传会话](https://apidoc.xunrua.top/477578412e0.md): 初始化上传会话（秒传/续传/新建）。需登录，受上传限流保护。 - 分片上传 [取消上传](https://apidoc.xunrua.top/477578413e0.md): 取消上传会话并清理已上传分片。需登录，受上传限流保护。 - 分片上传 [上传单个分片](https://apidoc.xunrua.top/477578414e0.md): 上传单个分片（原始二进制 body，≤32MB）。需登录，受上传限流保护。 - 分片上传 [合并所有分片](https://apidoc.xunrua.top/477578415e0.md): 合并所有分片完成上传。需登录，受上传限流保护。 - 分片上传 [查询上传状态](https://apidoc.xunrua.top/477578416e0.md): 查询上传会话状态（断点续传用）。需登录，受上传限流保护。 ## Schemas - [AddReactionRequest](https://apidoc.xunrua.top/287874956d0.md): - [AddSongRequest](https://apidoc.xunrua.top/287874957d0.md): - [AdminAnnouncementRequest](https://apidoc.xunrua.top/287874958d0.md): - [AdminCommentDTO](https://apidoc.xunrua.top/287874959d0.md): - [AdminUserDTO](https://apidoc.xunrua.top/287874960d0.md): - [AnnouncementDTO](https://apidoc.xunrua.top/287874961d0.md): - [AuditLog](https://apidoc.xunrua.top/287874962d0.md): - [BatchDeleteMediaRequest](https://apidoc.xunrua.top/287874963d0.md): - [BatchEmojiGroupStatusRequest](https://apidoc.xunrua.top/287874964d0.md): - [BatchReactionsRequest](https://apidoc.xunrua.top/287874965d0.md): - [BatchUpdateCommentStatusRequest](https://apidoc.xunrua.top/287874966d0.md): - [BatchUserRoleRequest](https://apidoc.xunrua.top/287874967d0.md): - [BatchUserStatusRequest](https://apidoc.xunrua.top/287874968d0.md): - [CSRFToken](https://apidoc.xunrua.top/287874969d0.md): - [ChangePasswordRequest](https://apidoc.xunrua.top/287874970d0.md): - [CommentDTO](https://apidoc.xunrua.top/287874971d0.md): - [CommentPicture](https://apidoc.xunrua.top/287874972d0.md): - [CommentReactionBatchResult](https://apidoc.xunrua.top/287874973d0.md): - [CreateCommentRequest](https://apidoc.xunrua.top/287874974d0.md): - [CreateCustomPlaylistRequest](https://apidoc.xunrua.top/287874975d0.md): - [CreateEmojiGroupRequest](https://apidoc.xunrua.top/287874976d0.md): - [CreateEmojiRequest](https://apidoc.xunrua.top/287874977d0.md): - [CreatePermissionRequest](https://apidoc.xunrua.top/287874978d0.md): - [CreatePostRequest](https://apidoc.xunrua.top/287874979d0.md): - [CreateRoleRequest](https://apidoc.xunrua.top/287874980d0.md): - [CreateTagRequest](https://apidoc.xunrua.top/287874981d0.md): - [CreateUserRequest](https://apidoc.xunrua.top/287874982d0.md): - [DashboardStats](https://apidoc.xunrua.top/287874983d0.md): - [EmojiDTO](https://apidoc.xunrua.top/287874984d0.md): - [EmojiGroupDTO](https://apidoc.xunrua.top/287874985d0.md): - [EmojiUploadResult](https://apidoc.xunrua.top/287874986d0.md): - [ErrorResponse](https://apidoc.xunrua.top/287874987d0.md): - [FileDTO](https://apidoc.xunrua.top/287874988d0.md): - [ForgotPasswordRequest](https://apidoc.xunrua.top/287874989d0.md): - [ImportPlaylistRequest](https://apidoc.xunrua.top/287874990d0.md): - [InitSessionResult](https://apidoc.xunrua.top/287874991d0.md): - [InitUploadSessionRequest](https://apidoc.xunrua.top/287874992d0.md): - [LoginRequest](https://apidoc.xunrua.top/287874993d0.md): - [LoginToken](https://apidoc.xunrua.top/287874994d0.md): - [MergeResult](https://apidoc.xunrua.top/287874995d0.md): - [MessageResponse](https://apidoc.xunrua.top/287874996d0.md): - [Meta](https://apidoc.xunrua.top/287874997d0.md): - [MusicEmbedInfo](https://apidoc.xunrua.top/287874998d0.md): - [MusicPlaylistMeta](https://apidoc.xunrua.top/287874999d0.md): - [MusicSettingsDTO](https://apidoc.xunrua.top/287875000d0.md): - [MusicSongMeta](https://apidoc.xunrua.top/287875001d0.md): - [Pagination](https://apidoc.xunrua.top/287875002d0.md): - [PermissionDTO](https://apidoc.xunrua.top/287875003d0.md): - [PlaylistDTO](https://apidoc.xunrua.top/287875004d0.md): - [PostDTO](https://apidoc.xunrua.top/287875005d0.md): - [PostSummary](https://apidoc.xunrua.top/287875006d0.md): - [ProfileResponse](https://apidoc.xunrua.top/287875007d0.md): - [ProjectDTO](https://apidoc.xunrua.top/287875008d0.md): - [PublicSettings](https://apidoc.xunrua.top/287875009d0.md): - [Reaction](https://apidoc.xunrua.top/287875010d0.md): - [RefreshRequest](https://apidoc.xunrua.top/287875011d0.md): - [RegisterRequest](https://apidoc.xunrua.top/287875012d0.md): - [ResetPasswordRequest](https://apidoc.xunrua.top/287875013d0.md): - [RoleDTO](https://apidoc.xunrua.top/287875014d0.md): - [RoleWithPermissionsDTO](https://apidoc.xunrua.top/287875015d0.md): - [SetPlaylistActiveRequest](https://apidoc.xunrua.top/287875016d0.md): - [SiteSettings](https://apidoc.xunrua.top/287875017d0.md): - [Song](https://apidoc.xunrua.top/287875018d0.md): - [TagDTO](https://apidoc.xunrua.top/287875019d0.md): - [UpdateEmojiGroupRequest](https://apidoc.xunrua.top/287875020d0.md): - [UpdateEmojiRequest](https://apidoc.xunrua.top/287875021d0.md): - [UpdatePermissionRequest](https://apidoc.xunrua.top/287875022d0.md): - [UpdatePlayerVersionRequest](https://apidoc.xunrua.top/287875023d0.md): - [UpdatePlaylistRequest](https://apidoc.xunrua.top/287875024d0.md): - [UpdatePostStatusRequest](https://apidoc.xunrua.top/287875025d0.md): - [UpdateProfileRequest](https://apidoc.xunrua.top/287875026d0.md): - [UpdateRolePermissionsRequest](https://apidoc.xunrua.top/287875027d0.md): - [UpdateRoleRequest](https://apidoc.xunrua.top/287875028d0.md): - [UpdateSettingsRequest](https://apidoc.xunrua.top/287875029d0.md): - [UpdateSongRequest](https://apidoc.xunrua.top/287875030d0.md): - [UpdateUserRequest](https://apidoc.xunrua.top/287875031d0.md): - [UpdateUserRoleRequest](https://apidoc.xunrua.top/287875032d0.md): - [UpdateUserStatusRequest](https://apidoc.xunrua.top/287875033d0.md): - [UserDTO](https://apidoc.xunrua.top/287875034d0.md): - [VerifyEmailRequest](https://apidoc.xunrua.top/287875035d0.md): - [ViewPoint](https://apidoc.xunrua.top/287875036d0.md): - [ViewTrends](https://apidoc.xunrua.top/287875037d0.md):