v56

latestSwagger 2.0Apache 2.0raw.githubusercontent.com2026-08-0616186383.8 KB
歌曲管理

预览批量整理歌曲文件

dry-run 预览目录整理变更,返回每项 old_path→new_path 与状态(ok/conflict/skip/error),不移动任何文件、不改数据库。target_path 为相对 music_path 的路径。CUE 歌曲 skip;目标已存在或批内撞名 conflict。music_path 由服务端自取。

post/api/v1/songs/organize/preview

Request body

idinteger
target_pathstring

Response

预览结果

errorstring
idinteger
new_pathstring
old_pathstring
statusstring