精简资源查询

筛选公开资源(HEAD)

HEAD /v1/resources
HEAD/v1/resources
下载规范

列表、计数与筛选读取同一快照。loader、mc、type 必须在同一原始发布记录上同时满足;同维度 OR、跨维度 AND。 HEAD 执行相同参数、认证与可见性检查,只返回状态和响应头。

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

查询参数

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

tagstring[]可选

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

条目数 ≤ 64

[]string

长度 ≥ 1 · 长度 ≤ 128

capabilitystring[]可选

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

条目数 ≤ 64

[]string

长度 ≥ 1 · 长度 ≤ 128

qstring可选

关键字最多 200 个 UTF-16 单元(补充平面字符占两个单元)。 单值参数,重复同名键返回 400。

长度 ≤ 200

sortstring可选默认值 "updated"

排序方式。 单值参数,重复同名键返回 400。

可选值"updated""downloads"
pageinteger可选默认值 1

页码;使用 cursor 时只能为 1。 单值参数,重复同名键返回 400。

≥ 1 · ≤ 1000

limitinteger可选默认值 20

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

≥ 1 · ≤ 50

cursorstring可选

不透明签名游标,仅允许 sort=updated 且 page=1;继续分页时保持其它筛选一致。格式、签名、版本或范围错误返回 400/INVALID_INPUT;列表快照过期返回 409/CURSOR_STALE。 单值参数,重复同名键返回 400。

长度 ≤ 4096

返回值

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

此响应没有正文。

响应头

Cache-Controlstring可选

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

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

接口: HEAD /v1/resources
operationId: publicV1HeadListResources

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

列表、计数与筛选读取同一快照。loader、mc、type 必须在同一原始发布记录上同时满足;同维度 OR、跨维度 AND。 HEAD 执行相同参数、认证与可见性检查,只返回状态和响应头。

参数:

  • 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 tag:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
  • query capability:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
  • query q:关键字最多 200 个 UTF-16 单元(补充平面字符占两个单元)。 单值参数,重复同名键返回 400。
  • query sort:排序方式。 单值参数,重复同名键返回 400。
  • query page:页码;使用 cursor 时只能为 1。 单值参数,重复同名键返回 400。
  • query limit:每次读取的最大条数。 单值参数,重复同名键返回 400。
  • query cursor:不透明签名游标,仅允许 sort=updated 且 page=1;继续分页时保持其它筛选一致。格式、签名、版本或范围错误返回 400/INVALID_INPUT;列表快照过期返回 409/CURSOR_STALE。 单值参数,重复同名键返回 400。