listFolderHolders

谁把这部作品放进了收藏夹

把某部作品收进收藏夹的那些账号,按 owner_uid 升序,一页一页给。**每种可见性的夹子都算**:这个面存在的理由是让服务把通知发给关注这部作品的人,私密夹里坐着的也是一个正等着被通知的人。它只回 uid,别的什么都不回——没有夹子 id、名字、可见性或计数——所以它没法被爬成一张「谁收藏了什么」的索引。没人收藏的作品是空列表,不是 404。要**应用密钥**,在 catalog:read 之上还要 folder_holders:read;用户访问令牌一律拒绝。这个 scope 由运营方授予、不能自助勾选,因为它答的是别人的私人收藏。

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

参数

参数类型位置说明
work_idstringquery

catalog 作品 id。必填。

cursorstringquery

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

limitstringquery

每页 1-100,默认 100。超过 100 是 400 LIMIT_TOO_LARGE,不会被截到上限。

响应

  • facetsmap<string, object[]>

    具名 facet 桶。仅在请求 facets= 时出现。

    • «key»object[] 可空
  • itemsobject[] 必填

    本页成员。空数组,从不为 null。

    • objectstring 必填

      类型判别字段。恒为 folder_holder。

      枚举folder_holder
    • owner_uidstring 必填

      至少有一个夹子收着这部作品的账号。这是全站统一登录的中心用户 id,不是某个站自己的用户 id。

  • 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/folders/holders" \
  -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。