listCatalogChanges
catalog 变更 feed
最近更新过的作品,最旧在前。keyset 分页。可匿名调用,按 IP 地址限流;应用密钥或带 catalog:read 的用户访问令牌各有更高的额度。不接受 ids=。 **这是镜像信道。** 若你按作品缓存任何 catalog 持有的事实——尤其是展示轴 `content_limit`,每部作品都带(直接从作品上读;不要用 `content_rating` 推算,那会漏掉封面全部被判 explicit 的作品)——请轮询本 feed,不要扫全量 catalog。凡改动作品认领状态、展示轴(编辑 NSFW 旗、内容分级,或其封面是否全部被判 explicit)、原语言 `olang` 或存在性的写入,都会 bump `updated_at` 并在此现身该 id。 从空 cursor 冷启动:本 feed 按最旧更新优先枚举整个人口,因此第一次抽干就是全量清单。每页用 ids= 以最多 100 一批打 /v2/catalog/works 做水合,两道闸都打开(nsfw=true 且不传 content_limit),然后保存 cursor,按自己的节奏轮询。 gone:带 `gone: true` 的条目已离开公开人口——丢掉镜像行。被合并走的 id 在此以 gone 出现,同时也出现在 /v2/catalog/redirects,后者给出接替它的 id;存在 redirect 时请改指向而不是删除。 作品提供的其余内容——covers、tags、titles、intros、ratings——尽力而为:这些写入多数也会 touch 作品,但只有认领状态、展示轴、`olang` 和存在性是承诺。
/v2/catalog/changescatalog:read可匿名调用(不带凭据按 IPv4 地址或 IPv6 /64 限流(默认 30 次/分钟、1,000 次/天);带 nmk_ 应用密钥或带 catalog:read 的用户访问令牌则走各自更高的额度)参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
cursor | string | query | 来自先前 next_cursor 的不透明 keyset cursor。必须以 cur_ 开头。 |
limit | string | query | 页大小 1-100,缺省 20。超过 100 为 400 LIMIT_TOO_LARGE,不钳制。 |
view | string | query | basic(默认)或 full。封闭词表。 |
include | string | query | 逗号分隔的块。未知 token 返回 400 UNKNOWN_INCLUDE。 |
fields | string | query | view/include 之后逗号分隔的顶层键。未知 token 返回 400 UNKNOWN_FIELD。object 与 id 始终保留。 |
ids | string | query | 逗号分隔的 id,最多 100 个。批量车道:无分页。 |
refs | string | query | 逗号分隔的 source:external_id,最多 100 个。批量车道:无分页。 |
include_total | string | query | true 则包含 total。仅 true 或 false。 |
facets | string | query | 逗号分隔的 facet 名称。未知 token 返回 400 UNKNOWN_FACET。 |
sort | string | query | 各集合封闭的排序键。 |
nsfw | string | query | true 包含 r18。false 或缺省则隐藏 r18。仅 true 或 false。 |
响应
facetsmap<string, object[]>具名 facet 桶。仅在请求 facets= 时出现。
«key»object[]可空
itemsobject[]必填本页成员。空数组,从不为 null。
goneboolean当 id 已离开公开人口时出现且为 true:已被合并走,或已不再提供。缺席表示该 id 仍为 live——从不下发 false。丢弃镜像行;若被合并,/v2/catalog/redirects 给出接替它的 id。
idstring必填被变更行的 catalog id。
objectstring必填类型判别字段。恒为 change。
枚举changetarget_objectstring必填发生变化的行所属的族。
枚举workreleasecharactercredit_namepersoncompanytagengineupdated_atstringdate-time 必填RFC 3339 UTC。该行最近一次变更的时刻,也是 cursor 续读的起点。
missingstring[]已请求但不可见的 ids。仅出现在 ids=/refs= 批量车道。
next_cursorstring不透明 keyset cursor。末页省略。
objectstring必填类型判别字段。恒为 list。
枚举listtotalintegerint64include_total=true 时出现;页码模式(page=)下恒在。与 items 同一个可见性闸。
total_relationstring仅在 page 模式出现。eq:total 为精确值。gte:total 为下界。
枚举eqgte
请求示例
curl "https://api.nextmoe.dev/v2/catalog/changes"