---
title: "获取指纹计算失败的歌曲列表"
method: GET
path: "/scan/fingerprints/failed"
tags: ["扫描管理"]
---

# 获取指纹计算失败的歌曲列表

`GET /scan/fingerprints/failed`

返回所有指纹计算失败的本地歌曲，包含失败原因。用于在重复检测页面展示失败详情。

## Response `200`

成功返回 {items: [...], total: N}

- object

## Other responses

- `500` — 服务器错误

## Changes

- **2026-09-01** `ef6d34af32c3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/scan/fingerprints/failed/get.md)

---

[API](https://skmtc.dev/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.dev/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/revisions/5b1368253f6c/schema)