1. 资源包 (Resource Packs)
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)
    • 管理员查询
      GET
    • 管理员更新
      PUT
  • 内容 (Content)
    • 获取内容
      GET
    • 创建内容
      POST
    • 更新内容
      PUT
    • 删除内容
      DELETE
  • 上传 (Upload)
    • 获取 presigned 上传地址 / 头像代理
    • 文件上传
  • 工具 (Utils)
    • 获取谱面元数据(不再服务端打包 zip)
  • 工单 (Tickets)
    • 工单: 列表 / 详情 / 统计
    • 工单: 创建 / 回复 / 认领 / 结案 / 驳回
  • 数据模型
    • User
    • Chart
    • ChartAsset
    • Error
    • Score
    • Record
    • ResourcePack
    • RecordProperties
  1. 资源包 (Resource Packs)

获取资源包列表/详情或下载资源包

GET
/api/v2/resource_packs
action=list:分页获取资源包,返回 { data: { items, total } },items 中 meta 为 MiluneResourcePack::MetaData(.mrp 服务端解析结果),file_url 为资源包文件地址;sort 可选 popular(默认,下载量降序)/ time-newest(最新上传)/ time-oldest(最早上传),q 为服务端模糊匹配(name / author / description)。action=detail:按 id 获取单个资源包。action=download:200 直接以 application/octet-stream 流式返回资源包文件并使下载计数 +1。默认情况下仅返回 approved;admin/reviewer/moderator 可通过 status=pending 或 all 查看非 approved 资源包。列表结果最多缓存 60 秒,新上传或审核后的变化可能延后最多 60 秒才可见(详情在下载后会立即失效刷新)。

请求参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.xhsr.org.cn/api/v2/resource_packs?action=&id=&sort=&page=&limit=&q=&status='

返回响应

🟢200
application/json
成功。action=list 返回 { data: { items, total } };detail 返回 { data: { ...ResourcePack } };download 直接以 application/octet-stream 流式返回资源包文件。
Body

示例
{
    "data": {
        "items": [
            {
                "id": 0,
                "meta": {
                    "name": "string",
                    "description": "string",
                    "version": "string",
                    "author": "string",
                    "license": "string",
                    "otherInformation": "string",
                    "createTime": 0,
                    "updateTime": 0
                },
                "file_url": "string",
                "status": "pending",
                "download_count": 0,
                "created_at": "2019-08-24T14:15:22.123Z"
            }
        ],
        "total": 0
    }
}
🟠400
🟠403
🟠404
🔴500
修改于 2026-10-07 10:19:10
上一页
上传游玩记录
下一页
上传资源包或审核资源包
Built with