Skip to content

歌单评论 ​

调用此接口,传入音乐 id 和 limit 参数,可获得该歌单的所有评论 ( 不需要

接口信息 ​

项目值
接口地址/comment/playlist
请求方式GET / POST
需要登录否
对应模块comment_playlist
文档分类评论

请求参数 ​

参数类型必填默认值说明
idstring✅-歌单 id
limitnumber | string—20取出评论数量,默认为 20
offsetnumber | string—-偏移数量,用于分页,如:(评论页数 - 1)*20, 其中 20 为 limit 的值
beforenumber | string—-分页参数,取上一页最后一项的 time 获取下一页数据(获取超过 5000 条评论的时候需要用到)

HTTP 示例 ​

bash
GET /comment/playlist?id=705123491

编程式调用 ​

ts
import { commentPlaylist } from 'hana-music-api';

const result = await commentPlaylist({
  id: '705123491',
});

console.log(result.body);

返回内容 ​

body.code、body.comments、body.comments[].commentId 收紧;body.hotComments 是可以没有的路径:越界分页时整个缺失,出现时 hotComments[].commentId 收紧。评论记录共用 CommentRecord,user、beReplied、likedCount、time、decoration、ipLocation、pendantData 等其余声明字段都宽松;beReplied[] 是评论里套着的回复记录,编号也宽松。total、more、moreHot、cnum、isMusician、userId 宽松。无评论歌单(录制 comment_playlist.empty.json,歌单 900000015)返回 comments: []、hotComments: []、total: 0;越界分页(录制 comment_playlist.out-of-range.json,offset=100000)返回 comments: [] 且没有 hotComments。topComments(只见过空数组)和 commentBanner(只见过 null)没有声明,原样保留。非空录制(comment_playlist.default.json)从原 20 条 comments/15 条 hotComments 中保留覆盖各字段的非连续 5/4 条。登录对照先用 login_status 确认 account.anonimousUser: false 后抽查:非 null 路径与类型相同,登录响应只会在宽松字段上多出现值为 null 的路径(如 comments[].user.vipRights、beReplied[].content/richContent、beReplied[].ipLocation.userId),登录录制未保留。

补充说明 ​

说明 : 调用此接口,传入音乐 id 和 limit 参数,可获得该歌单的所有评论 ( 不需要 登录 )

必选参数 : id: 歌单 id

可选参数 : limit: 取出评论数量,默认为 20

offset: 偏移数量,用于分页,如:(评论页数 - 1)*20, 其中 20 为 limit 的值

before: 分页参数,取上一页最后一项的 time 获取下一页数据(获取超过 5000 条评论的时候需要用到)

接口地址 : /comment/playlist

调用例子 : /comment/playlist?id=705123491

Released under the MIT License.