复制页面
Milracle-v2
认证 (Auth)
重定向认证操作 (OIDC / GitHub OAuth 回调)
GET
认证操作
POST
谱面 (Charts)
获取谱面列表或详情
GET
删除谱面
DELETE
删除谱面 (兼容旧客户端,使用 POST 代替 DELETE)
POST
Studio 管理:获取审核队列(支持待审核 / 上架申请 / 已通过 / 已上架 / 已拒绝等)
GET
Studio 操作:投票 / 申请上架 / 处理上架
POST
成绩 (Scores)
获取成绩
GET
上传成绩
POST
游玩记录 (Records)
获取游玩记录
GET
上传游玩记录
POST
资源包 (Resource Packs)
获取资源包列表/详情或下载资源包
GET
上传资源包或审核资源包
POST
用户 (User)
获取用户信息或用户列表
GET
用户操作(某些操作需管理员权限,例如修改其他用户)
POST
管理员 (Admin)
管理员查询
管理员更新
内容 (Content)
获取内容
创建内容
更新内容
删除内容
上传 (Upload)
获取 presigned 上传地址 / 头像代理
文件上传
工具 (Utils)
获取谱面元数据(不再服务端打包 zip)
工单 (Tickets)
工单: 列表 / 详情 / 统计
工单: 创建 / 回复 / 认领 / 结案 / 驳回
数据模型
User
Chart
ChartAsset
Error
Score
Record
ResourcePack
RecordProperties
Error
复制页面
统一错误响应体。error 为面向用户的文案;code 为机器可读错误码。生产环境不回显内部错误详情。
{
"error"
:
"string"
,
"code"
:
"string"
}