---
title: "导入歌单备份"
method: POST
path: "/playlists/import"
tags: ["数据备份"]
---

# 导入歌单备份

`POST /playlists/import`

从 multipart/form-data 上传的 JSON 备份文件还原歌单。已存在的歌单按名称合并，曲目按内容匹配去重。

## Response `200`

导入结果（新建/合并歌单数、新建/匹配曲目数）

- ModelsImportResult
  - `playlists_created` integer
  - `playlists_merged` integer
  - `songs_created` integer
  - `songs_matched` integer
  - `songs_skipped` integer

## Other responses

- `400` — 请求格式错误或文件无效
- `500` — 导入失败

---

[API](https://skmtc.net/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.net/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/versions/e4d4950ef665/schema)