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

    RecordProperties

    MilRecord::Properties,即客户端写入记录 ASAR 中的 meta JSON。服务端原样存储并原样返回,不增删、不重命名字段;下面列出的是服务端已知并会使用的字段,客户端写入的其余字段(additionalProperties)同样会透传。迁移 27 之前上传的记录没有原始 JSON,服务端会用下列同名字段从数据库列重建。

    {
        "username": "string",
        "user_id": "string",
        "online_id": "string",
        "chart_hash": "string",
        "chart_env": "string",
        "game_version": "string",
        "modifiers": "string",
        "grade": "string",
        "score": 0,
        "score_accuracy": 0,
        "score_exact_count": 0,
        "score_perfect_count": 0,
        "score_great_count": 0,
        "score_good_count": 0,
        "score_bad_count": 0,
        "score_miss_count": 0,
        "score_fracture_exact_count": 0,
        "score_fracture_miss_count": 0,
        "played_at": "string",
        "extra_info": "string",
        "property1": "string",
        "property2": "string"
    }
    Built with