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 作品,但只有认领状态、展示轴和存在性是承诺。

get/v2/catalog/changes
scope catalog:readAuthorization: Bearer nmk_live_…(v2 应用密钥,门户自助铸造,无需申请)

参数

参数类型位置说明
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 时出现。与 items 同一可见性闸。

请求示例

cURL
curl "https://api.nextmoe.dev/v2/catalog/changes" \
  -H "Authorization: Bearer nmk_live_<YOUR_KEY>"

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

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