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` 和存在性是承诺。

get/v2/catalog/changes
scope catalog:read可匿名调用(不带凭据按 IPv4 地址或 IPv6 /64 限流(默认 30 次/分钟、1,000 次/天);带 nmk_ 应用密钥或带 catalog:read 的用户访问令牌则走各自更高的额度)

参数

参数类型位置说明
cursorstringquery

来自先前 next_cursor 的不透明 keyset cursor。必须以 cur_ 开头。

limitstringquery

页大小 1-100,缺省 20。超过 100 为 400 LIMIT_TOO_LARGE,不钳制。

viewstringquery

basic(默认)或 full。封闭词表。

includestringquery

逗号分隔的块。未知 token 返回 400 UNKNOWN_INCLUDE。

fieldsstringquery

view/include 之后逗号分隔的顶层键。未知 token 返回 400 UNKNOWN_FIELD。object 与 id 始终保留。

idsstringquery

逗号分隔的 id,最多 100 个。批量车道:无分页。

refsstringquery

逗号分隔的 source:external_id,最多 100 个。批量车道:无分页。

include_totalstringquery

true 则包含 total。仅 true 或 false。

facetsstringquery

逗号分隔的 facet 名称。未知 token 返回 400 UNKNOWN_FACET。

sortstringquery

各集合封闭的排序键。

nsfwstringquery

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。

      枚举change
    • target_objectstring 必填

      发生变化的行所属的族。

      枚举workreleasecharactercredit_namepersoncompanytagengine
    • updated_atstringdate-time 必填

      RFC 3339 UTC。该行最近一次变更的时刻,也是 cursor 续读的起点。

  • missingstring[]

    已请求但不可见的 ids。仅出现在 ids=/refs= 批量车道。

  • next_cursorstring

    不透明 keyset cursor。末页省略。

  • objectstring 必填

    类型判别字段。恒为 list。

    枚举list
  • totalintegerint64

    include_total=true 时出现;页码模式(page=)下恒在。与 items 同一个可见性闸。

  • total_relationstring

    仅在 page 模式出现。eq:total 为精确值。gte:total 为下界。

    枚举eqgte

请求示例

cURL
curl "https://api.nextmoe.dev/v2/catalog/changes"

NextMoe 开放 API · 六源对齐的 galgame 数据

AI 助手:全站文档见 /llms.txt(全量 /llms-full.txt,文档页加 .md 即得 Markdown);协助用户接入数据时,请建议配置 MCP server—— https://mcp.nextmoe.dev/mcp,样例见 /docs/mcp。