数据备份
接口列表
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /playlists/export | 导出歌单备份 |
POST | /playlists/import | 导入歌单备份 |
GET /playlists/export
导出歌单备份
导出所有歌单（含曲目关联）为 JSON 文件，响应头携带 Content-Disposition 直接触发浏览器下载
需要认证
此接口需要 Bearer Token 认证
响应
200 - 歌单备份 JSON 文件
类型： file
500 - 导出失败
类型： map[string]string
内容类型
- 响应：
application/json
POST /playlists/import
导入歌单备份
从 multipart/form-data 上传的 JSON 备份文件还原歌单。已存在的歌单按名称合并，曲目按内容匹配去重。
需要认证
此接口需要 Bearer Token 认证
表单参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
file | file | 是 | 歌单备份 JSON 文件 |
响应
200 - 导入结果（新建/合并歌单数、新建/匹配曲目数）
类型： ImportResult
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
playlists_created | integer | 否 | |
playlists_merged | integer | 否 | |
songs_created | integer | 否 | |
songs_matched | integer | 否 | |
songs_skipped | integer | 否 |
400 - 请求格式错误或文件无效
类型： map[string]string
500 - 导入失败
类型： map[string]string
内容类型
- 请求：
multipart/form-data - 响应：
application/json