purgeUserFolders
清空某个账号的全部收藏夹
注销账号时调用的就是它:在一个事务里删掉该账号的全部收藏夹、其中的条目,以及指向它们的导入台账。返回一张带数量的回执;账号一个收藏夹都没有时返回 200 和两个 0,不是 404。需要持有人具备 catalog.folder.moderate 权限的用户访问令牌:moderator、admin、ren 角色默认具备,权限控制台可以授予其他角色。审核目录编辑或投稿认领的权限不包含它。
delete
/v2/moderation/users/{uid}/foldersAuthorization: Bearer <用户访问令牌>(用户授权后的访问令牌,不是 API 密钥)参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
uid 必填 | string | path | 要清空谁的收藏夹。 |
响应
folders_deletedintegerint64 必填被删除的收藏夹数。账号本来就没有时是 0,这不是错误。
items_deletedintegerint64 必填随之删除的收藏条目数。
objectstring必填类型判别字段,恒为 folder_purge。
枚举folder_purgeowner_uidstring必填被清空收藏夹的账号。
请求示例
cURL
curl -X DELETE "https://api.nextmoe.dev/v2/moderation/users/1/folders" \
-H "Authorization: Bearer <ACCESS_TOKEN>"