refactor: 自动生成sessionID

2026-10-20 14:41:23 +08:00 · 2026-06-06 15:33:15 +08:00
parent 65261fa658
commit e7ff0da4ba
3 changed files with 38 additions and 167 deletions
@@ -2492,6 +2492,18 @@ privilege:权限相关信息

 **调用例子 :** `/scrobble?id=518066366&sourceid=36780169&time=291`

+### 提交歌曲播放状态
+
+说明 : 调用此接口可提交歌曲播放状态，支持会话追踪和播放模式记录，未传入 `sessionId` 时后端会自动生成
+
+**必选参数 :** `id`: 歌曲 id
+
+**可选参数 :** `sessionId`: 播放会话 ID（12 位大写字母和数字），不传则自动生成, `progress`: 播放进度（秒），默认 0, `playMode`: 播放模式，默认 `list_loop`, `type`: 资源类型，默认 `song`
+
+**接口地址 :** `/relay/play/state/submit`
+
+**调用例子 :** `/relay/play/state/submit?id=518066366&progress=30`
+
 ### 热门歌手

 说明 : 调用此接口 , 可获取热门歌手数据