listCatalogChanges
catalog 变更 feed
最近更新过的作品,最旧在前。keyset 分页。需要应用密钥。不接受 ids=。 **这是镜像信道。** 若你按作品缓存任何 catalog 持有的事实——尤其是编辑展示轴 `content_limit`,其判定在认领块存在时为 `claimed_by.content_limit`,否则当 `content_rating` 为 `r18` 时为 `nsfw`、其余为 `sfw`——请轮询本 feed,不要扫全量 catalog。凡改动作品认领状态、展示轴(编辑 NSFW 旗或其内容分级)或存在性的写入,都会 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 作品,但只有认领状态、展示轴和存在性是承诺。
/v2/catalog/changescatalog:readAuthorization: Bearer nmk_live_…(v2 应用密钥,门户自助铸造,无需申请)参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
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。
枚举listtotalintegerint64仅当 include_total=true 时出现。与 items 同一可见性闸。
请求示例
curl "https://api.nextmoe.dev/v2/catalog/changes" \
-H "Authorization: Bearer nmk_live_<YOUR_KEY>"