精简资源查询

读取公开资源详情

GET /v1/resources/{slug}
GET/v1/resources/{slug}
下载规范

返回稳定资源投影,不嵌入发布历史。构建选择请使用 updates;其兼容性仍在同一原始发布记录上判断。

无需认证;可选 Bearer 令牌(resource:read:feed),拒绝 Cookie

路径参数

slugstring必填

小写 ASCII 字母数字及单连字符,长度 1–100。

长度 ≥ 1 · 长度 ≤ 100 · 格式:^[a-z0-9]+(?:-[a-z0-9]+)*$

查询参数

loaderstring[]可选

可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。

条目数 ≤ 64

[]string

长度 ≥ 1 · 长度 ≤ 128

mcstring[]可选

可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。

条目数 ≤ 64

[]string

长度 ≥ 1 · 长度 ≤ 128

typestring[]可选

可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。

条目数 ≤ 64

[]string

长度 ≥ 1 · 长度 ≤ 128

返回值

成功。所有声明的 JSON 字段稳定存在,空值明确为 null。

resourceobject必填
idstring必填

不透明资源 ID。

slugstring必填
titlestring必填
summarystring必填
ownerIdstring必填

不透明所有者 ID,不包含账户私有资料。

coverUrlstring | null必填

格式:uri

tagsobject[]必填
slugstring必填
labelstring必填
dimensionstring必填

开放标签维度:gameplay、style、quality 或 unclassified。

capabilitiesstring[]必填

能力 ID;不包含网站展示结构或任意能力载荷。

[]string
loadersstring[]必填
[]string
releaseCountinteger必填

展示合并单元总数,并非原始发布行数。

≥ 0 · ≤ 4294967295

matchedReleaseCountinteger必填

同一原始发布记录满足当前 loader、mc、type 条件的展示合并单元数。

≥ 0 · ≤ 4294967295

bodystring | null必填

原始正文文本;客户端按自己的输出上下文安全呈现,不执行其中的 HTML。

mcVersionsstring[]必填
[]string

响应头

Cache-Controlstring可选

不得缓存到共享或持久缓存。

可选值"private, no-store"
X-Content-Type-Optionsstring可选
可选值"nosniff"
接口信息

接口: GET /v1/resources/{slug}
operationId: publicV1GetResource

使用令牌时所需权限: resource:read:feed

返回稳定资源投影,不嵌入发布历史。构建选择请使用 updates;其兼容性仍在同一原始发布记录上判断。

参数:

  • path slug(必填):小写 ASCII 字母数字及单连字符,长度 1–100。
  • query loader:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
  • query mc:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
  • query type:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。