文档 API v2getPublicFolder

getPublicFolder

读取一个公开收藏夹

这个 id 没有对应的公开收藏夹时返回 404——不管是它不存在，还是夹主把它设成了私密。owner_uid 指出它属于哪个账号。需要应用密钥或带 catalog:read 的用户访问令牌。

get/v2/folders/{id}

scope catalog:readAuthorization: Bearer nmk_live_…（v2 应用密钥,门户自助铸造,无需申请）

参数

参数	类型	位置	说明
`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/folders/1" \
  -H "Authorization: Bearer nmk_live_<YOUR_KEY>"