---
title: "等待收藏成员变更"
method: GET
path: "/playlists/favorites/changes"
tags: ["歌单管理"]
---

# 等待收藏成员变更

`GET /playlists/favorites/changes`

## Request

- Base URL: `https://localhost:58091/api/v1`
- URL: `https://localhost:58091/api/v1/playlists/favorites/changes`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/songloft-org/apis/songloft-api/docs/playlists/favorites/changes/get.ts> (a function with typed inputs; its response is checked against the schema)

首次不传 cursor 或服务端重启后立即返回 changed=true，客户端刷新歌曲和电台收藏缓存。传入上次 cursor 后最多等待 25 秒；成员写入提交后立即唤醒所有等待者，无变更超时返回 changed=false。cursor 不透明，仅用于缓存失效，不是可重放事件日志。需通过正常认证，断开连接取消等待。

## Query parameters

- `cursor` string

## Response `200`

收藏缓存失效通知或等待超时

- ServicesFavoriteChangesResponse
  - `changed` boolean
  - `cursor` string

## Other responses

- `401`: 未认证或凭证失效
- `503`: 服务端正在关闭

## Changes

- **2026-11-10** `73a5de38b8a1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/playlists/favorites/changes/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.dev/songloft-org/apis/songloft-api/revisions/73a5de38b8a1?raw)