feat(playlist_track_all): 增加offset偏移量设置

2026-10-20 22:51:23 +08:00 · 2022-01-15 13:06:18 +08:00
parent 4200833a30
commit 845c357aa3
3 changed files with 14 additions and 129 deletions
@@ -1316,12 +1316,20 @@ tags: 歌单标签

 **必选参数 :** `id` : 歌单 id

-**可选参数 :** `limit` : 限制获取歌曲的数量
+**可选参数 :** `limit` : 限制获取歌曲的数量，默认值为当前歌单的歌曲数量
+
+**可选参数 :** `offset` : 默认值为0，用于歌曲的分页，计算方法为 `limit` * `offset`<= 你得到的歌曲 <= `limit` * `offset + 1` 

 **接口地址 :** `/playlist/track/all`

 **调用例子 :** `/playlist/track/all?id=24381616&limit=10`

+> 注：关于`offset`，你可以这样理解，假设你当前的歌单有100首歌
+> 
+> 你传入limit=10&offset=1，你会得到第11-20首歌曲
+> 
+> 如果你设置limit=10&offset=2，你就会得到第21-30首歌曲
+
 ### 歌单详情动态

 说明 : 调用后可获取歌单详情动态部分,如评论数,是否收藏,播放数