putMyFolderItem

向收藏夹添加一部作品

天然幂等:重复添加一条已存在的条目会返回已存的那一行,不改动任何东西。需要带 folder:write 的用户访问令牌。

put/v2/me/folders/{id}/items/{work_id}
scope folder:writeAuthorization: Bearer <用户访问令牌>(用户授权后的访问令牌,不是 API 密钥)

参数

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

收藏夹 id。

work_id 必填 stringpath

作品 id。

响应

  • created_atstringdate-time 必填

    RFC 3339 UTC,作品加入的时刻。

  • folder_idstring 必填

    该条目所属的收藏夹。

  • objectstring 必填

    类型判别字段。恒为 folder_item。

    枚举folder_item
  • updated_atstringdate-time 必填

    RFC 3339 UTC。增量同步的水位线;重复添加一条已存在的条目不会改动它。

  • work_idstring 必填

    作品 id。

请求示例

cURL
curl -X PUT "https://api.nextmoe.dev/v2/me/folders/1/items/1" \
  -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。