文档 API v2getMyFolder

getMyFolder

获取单个收藏夹

持有者名下没有该 id 的收藏夹时返回 404。需要带 folder:read 的用户访问令牌（folder:write 同样满足读取）。

get/v2/me/folders/{id}

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

参数

参数	类型	位置	说明
`id` 必填	`string`	`path`	收藏夹 id。

created_atstringdate-time 必填
RFC 3339 UTC。
descriptionstring 必填
拥有者自己的备注。没有则为空字符串。不得用作判别条件。
idstring 必填
收藏夹 id。
is_defaultboolean 必填
每个用户至多一个收藏夹带此标记。把它设到某个收藏夹上会清除原持有者的标记。
item_countintegerint64 必填
该收藏夹内的作品数量。
namestring 必填
展示名。不得用作判别条件。
objectstring 必填
类型判别字段。恒为 folder。
枚举folder
owner_uidstring 必填
拥有这个收藏夹的账号。这是 NextMoe 各站共用的中央登录用户 id，不是某个站自己的用户 id。
updated_atstringdate-time 必填
RFC 3339 UTC。
visibilitystring 必填
public 的收藏夹任何人都可以通过 /v2/folders 读到；private 的只有夹主自己能看见，走 /v2/me/folders。
枚举privatepublic

cURL

curl "https://api.nextmoe.dev/v2/me/folders/1" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"