putMyFolderItem
向收藏夹添加一部作品
天然幂等:重复添加一条已存在的条目会返回已存的那一行,不改动任何东西。需要带 folder:write 的用户访问令牌。
put
/v2/me/folders/{id}/items/{work_id} scope
folder:writeAuthorization: Bearer <用户访问令牌>(用户授权后的访问令牌,不是 API 密钥)参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
id 必填 | string | path | 收藏夹 id。 |
work_id 必填 | string | path | 作品 id。 |
响应
created_atstringdate-time 必填RFC 3339 UTC,作品加入的时刻。
folder_idstring必填该条目所属的收藏夹。
objectstring必填类型判别字段。恒为 folder_item。
枚举folder_itemupdated_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>"