精简资源查询

读取当前兼容更新构建(HEAD)

HEAD /v1/resources/{slug}/updates
HEAD/v1/resources/{slug}/updates
下载规范

当前公开原始发布快照,默认稳定渠道,按发布时间倒序。相同文件和版本号也不合并兼容配对。无历史游标,hasMore 表示还有更旧构建;安装前再次复核。 HEAD 执行相同参数、认证与可见性检查,只返回状态和响应头。

无需认证;可选 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

releaseTypestring[]可选默认值 ["release"]

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

条目数 ≤ 64

[]string
可选值"release""beta""alpha"
limitinteger可选默认值 20

每次读取的最大条数。 单值参数,重复同名键返回 400。

≥ 1 · ≤ 50

请求头

If-None-Matchstring可选

支持单个或逗号分隔的 ETag、弱标签以及 *。公开 ETag 绑定 PUBLIC_API_SITE_ORIGIN;网关只将当前 origin 的有效公开标签解包后传给 Node,Node 每次仍执行用户认证与资源可见性门禁。未知标签或旧 origin 标签作为不匹配处理,返回 200;* 保留正常存在性语义,也须经过同样门禁。不能在网关仅凭旧缓存返回 304。

返回值

与 GET 相同的状态和响应头,不发送响应正文。

此响应没有正文。

响应头

Cache-Controlstring可选

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

可选值"private, no-store"
X-Content-Type-Optionsstring可选
可选值"nosniff"
ETagstring可选

当前 v1 HTTP JSON 表示的实体标签,绑定 PUBLIC_API_SITE_ORIGIN 网站 origin,因为下载 URL 的绝对化会改变表示;仅在本次完整查询和权限复核后产生。

接口信息

接口: HEAD /v1/resources/{slug}/updates
operationId: publicV1HeadResourceUpdates

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

当前公开原始发布快照,默认稳定渠道,按发布时间倒序。相同文件和版本号也不合并兼容配对。无历史游标,hasMore 表示还有更旧构建;安装前再次复核。 HEAD 执行相同参数、认证与可见性检查,只返回状态和响应头。

参数:

  • 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 控制字符。
  • query releaseType:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
  • query limit:每次读取的最大条数。 单值参数,重复同名键返回 400。
  • header If-None-Match:支持单个或逗号分隔的 ETag、弱标签以及 。公开 ETag 绑定 PUBLIC_API_SITE_ORIGIN;网关只将当前 origin 的有效公开标签解包后传给 Node,Node 每次仍执行用户认证与资源可见性门禁。未知标签或旧 origin 标签作为不匹配处理,返回 200; 保留正常存在性语义,也须经过同样门禁。不能在网关仅凭旧缓存返回 304。