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_id | string | query | catalog 作品 id。必填。 |
cursor | string | query | 来自先前 next_cursor 的不透明 keyset cursor。必须以 cur_ 开头。 |
limit | string | query | 每页 1-100,默认 100。超过 100 是 400 LIMIT_TOO_LARGE,不会被截到上限。 |
响应
facetsmap<string, object[]>具名 facet 桶。仅在请求 facets= 时出现。
«key»object[]可空
itemsobject[]必填本页成员。空数组,从不为 null。
objectstring必填类型判别字段。恒为 folder_holder。
枚举folder_holderowner_uidstring必填至少有一个夹子收着这部作品的账号。这是全站统一登录的中心用户 id,不是某个站自己的用户 id。
missingstring[]已请求但不可见的 ids。仅出现在 ids=/refs= 批量车道。
next_cursorstring不透明 keyset cursor。末页省略。
objectstring必填类型判别字段。恒为 list。
枚举listtotalintegerint64include_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>"