筛选公开资源
/v1/resources列表、计数与筛选读取同一快照。loader、mc、type 必须在同一原始发布记录上同时满足;同维度 OR、跨维度 AND。
无需认证;可选 Bearer 令牌(resource:read:feed),拒绝 Cookie
查询参数
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
tagstring[]可选可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
条目数 ≤ 64
tagstring[]可选可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
[]string长度 ≥ 1 · 长度 ≤ 128
capabilitystring[]可选可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
条目数 ≤ 64
capabilitystring[]可选可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。
[]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
返回值
成功。所有声明的 JSON 字段稳定存在,空值明确为 null。
itemsobject[]必填条目数 ≤ 50
itemsobject[]必填idstring必填不透明资源 ID。
slugstring必填titlestring必填summarystring必填ownerIdstring必填不透明所有者 ID,不包含账户私有资料。
coverUrlstring | null必填格式:uri
tagsobject[]必填
tagsobject[]必填slugstring必填labelstring必填dimensionstring必填开放标签维度:gameplay、style、quality 或 unclassified。
capabilitiesstring[]必填能力 ID;不包含网站展示结构或任意能力载荷。
capabilitiesstring[]必填能力 ID;不包含网站展示结构或任意能力载荷。
[]stringloadersstring[]必填
loadersstring[]必填[]stringreleaseCountinteger必填展示合并单元总数,并非原始发布行数。
≥ 0 · ≤ 4294967295
matchedReleaseCountinteger必填同一原始发布记录满足当前 loader、mc、type 条件的展示合并单元数。
≥ 0 · ≤ 4294967295
totalstring必填非负十进制整数字符串;不要转换成可能丢失精度的 JavaScript number。
格式:^(0|[1-9][0-9]*)$
pageinteger必填≥ 1 · ≤ 1000
limitinteger必填≥ 1 · ≤ 50
nextCursorstring | null必填不透明游标;没有后续游标时固定为 null。仅 updated 排序提供。
响应头
Cache-Controlstring可选不得缓存到共享或持久缓存。
"private, no-store"X-Content-Type-Optionsstring可选"nosniff"接口信息
接口: GET /v1/resources
operationId: publicV1ListResources
使用令牌时所需权限: resource:read:feed
列表、计数与筛选读取同一快照。loader、mc、type 必须在同一原始发布记录上同时满足;同维度 OR、跨维度 AND。
参数:
queryloader:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。querymc:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。querytype:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。querytag:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。querycapability:可重复同名参数,也可用逗号分隔;同维度为 OR,跨维度为 AND。每维最多 64 个非空值,每值最多 128 个字符;在 trim 去除首尾空白前拒绝 C0/DEL 控制字符。queryq:关键字最多 200 个 UTF-16 单元(补充平面字符占两个单元)。 单值参数,重复同名键返回 400。querysort:排序方式。 单值参数,重复同名键返回 400。querypage:页码;使用 cursor 时只能为 1。 单值参数,重复同名键返回 400。querylimit:每次读取的最大条数。 单值参数,重复同名键返回 400。querycursor:不透明签名游标,仅允许 sort=updated 且 page=1;继续分页时保持其它筛选一致。格式、签名、版本或范围错误返回 400/INVALID_INPUT;列表快照过期返回 409/CURSOR_STALE。 单值参数,重复同名键返回 400。