文档 API v2listMyFolderHoldings

listMyFolderHoldings

我的哪些收藏夹收着这些作品

一次问最多 100 部作品的成员关系：对持令牌者至少收进一个夹子的每部作品，给出那些夹子的 id。一个哪儿都没收的作品会被**略去**，而不是回一个空数组；指不到任何作品的 id 同样只是「哪儿都没收」。每种可见性的夹子都在搜索范围内——它们都是持令牌者自己的。work_ids 必填；这是批量读，没有翻页。要带 folder:read 的用户访问令牌（folder:write 同时给读）。

get/v2/me/folders/holdings

scope folder:read 或 folder:writeAuthorization: Bearer <用户访问令牌>（用户授权后的访问令牌,不是 API 密钥）

参数

参数	类型	位置	说明
`work_ids`	`string`	`query`	逗号分隔的作品 id，最多 100 个。批量读取，无分页。

响应

facetsmap<string, object[]>
具名 facet 桶。仅在请求 facets= 时出现。
- «key»object[] 可空
itemsobject[] 必填
本页成员。空数组，从不为 null。
- folder_idsstring[] 必填
  调用者自己收着这部作品的夹子，按 id 升序。**永不为空**：一个没有任何夹子收着的作品会直接不出现在列表里。
- objectstring 必填
  类型判别字段。恒为 folder_holding。
  枚举folder_holding
- work_idstring 必填
  作品 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/me/folders/holdings" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"