读取当前兼容更新构建
/v1/resources/{slug}/updates当前公开原始发布快照,默认稳定渠道,按发布时间倒序。相同文件和版本号也不合并兼容配对。无历史游标,hasMore 表示还有更旧构建;安装前再次复核。
无需认证;可选 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
loaderstring[]可选可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
[]string长度 ≥ 1 · 长度 ≤ 128
mcstring[]可选可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
条目数 ≤ 64
mcstring[]可选可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
[]string长度 ≥ 1 · 长度 ≤ 128
typestring[]可选可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
条目数 ≤ 64
typestring[]可选可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
[]string长度 ≥ 1 · 长度 ≤ 128
releaseTypestring[]可选默认值 ["release"]可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
条目数 ≤ 64
releaseTypestring[]可选默认值 ["release"]可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
[]string"release""beta""alpha"limitinteger可选默认值 20每次读取的最大条数。 单值参数,重复同名键返回 400。
≥ 1 · ≤ 50
请求头
If-None-Matchstring可选支持单个或逗号分隔的 ETag、弱标签以及 *。公开 ETag 绑定 PUBLIC_API_SITE_ORIGIN;网关只将当前 origin 的有效公开标签解包后传给 Node,Node 每次仍执行用户认证与资源可见性门禁。未知标签或旧 origin 标签作为不匹配处理,返回 200;* 保留正常存在性语义,也须经过同样门禁。不能在网关仅凭旧缓存返回 304。
返回值
成功。所有声明的 JSON 字段稳定存在,空值明确为 null。
resourceobject必填
resourceobject必填idstring必填slugstring必填titlestring必填revisionstring必填不透明当前快照 revision,不能当作时间或历史事件序号。
itemsobject[]必填条目数 ≤ 50
itemsobject[]必填idstring必填versionNumberstring必填namestring | null必填releaseTypestring必填"release""beta""alpha"publishedAtstring必填UTC 发布时间字符串,保留原始微秒精度;不要重新格式化后用于排序或游标。
格式:date-time
loadersstring[]必填
loadersstring[]必填[]stringmcVersionsstring[]必填
mcVersionsstring[]必填[]stringfilesobject[]必填
filesobject[]必填idstring必填filenamestring必填sizestring必填非负十进制整数字符串;不要转换成可能丢失精度的 JavaScript number。
格式:^(0|[1-9][0-9]*)$
sha512string | null必填已知的 SHA512;未知时固定为 null。哈希不授予文件所有权或读取权限。
isPrimaryboolean必填urlstring必填绝对下载 URL;读取可能仍需相应权限。
格式:uri
formatstring必填hasMoreboolean必填还有更旧的当前公开构建;本接口不提供历史分页游标。
响应头
Cache-Controlstring可选不得缓存到共享或持久缓存。
"private, no-store"X-Content-Type-Optionsstring可选"nosniff"ETagstring可选当前 v1 HTTP JSON 表示的实体标签,绑定 PUBLIC_API_SITE_ORIGIN 网站 origin,因为下载 URL 的绝对化会改变表示;仅在本次完整查询和权限复核后产生。
接口信息
接口: GET /v1/resources/{slug}/updates
operationId: publicV1ResourceUpdates
使用令牌时所需权限: resource:read:feed
当前公开原始发布快照,默认稳定渠道,按发布时间倒序。相同文件和版本号也不合并兼容配对。无历史游标,hasMore 表示还有更旧构建;安装前再次复核。
参数:
pathslug(必填):小写 ASCII 字母数字及单连字符,长度 1–100。queryloader:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。querymc:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。querytype:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。queryreleaseType:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。querylimit:每次读取的最大条数。 单值参数,重复同名键返回 400。headerIf-None-Match:支持单个或逗号分隔的 ETag、弱标签以及 。公开 ETag 绑定 PUBLIC_API_SITE_ORIGIN;网关只将当前 origin 的有效公开标签解包后传给 Node,Node 每次仍执行用户认证与资源可见性门禁。未知标签或旧 origin 标签作为不匹配处理,返回 200; 保留正常存在性语义,也须经过同样门禁。不能在网关仅凭旧缓存返回 304。