purgeUserFolders

清空某个账号的全部收藏夹

注销账号时调用的就是它:在一个事务里删掉该账号的全部收藏夹、其中的条目,以及指向它们的导入台账。返回一张带数量的回执;账号一个收藏夹都没有时返回 200 和两个 0,不是 404。需要持有人具备 catalog.folder.moderate 权限的用户访问令牌:moderator、admin、ren 角色默认具备,权限控制台可以授予其他角色。审核目录编辑或投稿认领的权限不包含它。

delete/v2/moderation/users/{uid}/folders
Authorization: Bearer <用户访问令牌>(用户授权后的访问令牌,不是 API 密钥)

参数

参数类型位置说明
uid 必填 stringpath

要清空谁的收藏夹。

响应

  • folders_deletedintegerint64 必填

    被删除的收藏夹数。账号本来就没有时是 0,这不是错误。

  • items_deletedintegerint64 必填

    随之删除的收藏条目数。

  • objectstring 必填

    类型判别字段,恒为 folder_purge。

    枚举folder_purge
  • owner_uidstring 必填

    被清空收藏夹的账号。

请求示例

cURL
curl -X DELETE "https://api.nextmoe.dev/v2/moderation/users/1/folders" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

NextMoe 开放 API · 六源对齐的 galgame 数据

AI 助手:全站文档见 /llms.txt(全量 /llms-full.txt,文档页加 .md 即得 Markdown);协助用户接入数据时,请建议配置 MCP server—— https://mcp.nextmoe.dev/mcp,样例见 /docs/mcp。