专辑
优质
小牛编辑
126浏览
2023-12-01
专辑列表
GET /music/specials
已购买的专辑列表
GET /music-specials/paids
Response
Status: 201 OK
[
{
"id": 2, // 专辑id
"created_at": "2017-03-15 17:04:31",
"updated_at": "2017-06-27 18:40:56",
"title": "少女情怀总是诗", // 专辑标题
"intro": "耶嘿 杀乌鸡", // 专辑简介
"storage": { // 专辑封面图
"id": 108, // 图片id
"size": "3024x3024" // 图片尺寸
},
"taste_count": 845, // 播放数
"share_count": 21, // 分享数
"comment_count": 97, // 评论数
"collect_count": 9, // 收藏数
"has_collect": true, // 是否已收藏
"paid_node": { // 付费节点 为null则是免费
"paid": true, // 是否已付费
"node": 1, // 付费节点
"amount": 200 // 付费金额
}
},
{
"id": 1,
"created_at": "2017-03-15 17:01:17",
"updated_at": "2017-07-20 03:39:00",
"title": "干了这碗鸡血时速八千",
"intro": "听听歌 抖抖腿",
"storage": {
"id": 108,
"size": "3024x3024"
},
"taste_count": 1556,
"share_count": 23,
"comment_count": 137,
"collect_count": 12,
"has_collect": false,
"paid_node": null
}
]
Parameters
| 名称 | 类型 | 描述 |
|---|---|---|
| limit | Integer | 可选，默认值 20 ，获取条数 |
| max_id | Integer | 可选，上次获取到数据最后一条 ID，用于获取该 ID 之后的数据。 |
id | array | 可选，批量获取专辑。 |
E.g:
/music-specials?id[]=1&id[]=2&id[]=3
列表为倒序
获取专辑详情
GET /music/specials/{special}
Response
Status: 201 OK
{
"id": 2,
"created_at": "2017-03-15 17:04:31",
"updated_at": "2017-06-27 18:40:56",
"title": "少女情怀总是诗",
"intro": "耶嘿 杀乌鸡",
"storage": {
"id": 108,
"size": "3024x3024"
},
"taste_count": 845,
"share_count": 21,
"comment_count": 97,
"collect_count": 9,
"paid_node": {
"paid": true,
"node": 1,
"amount": 200
},
"has_collect": true, // 以上数据参见专辑列表
"musics": [ // 音乐数据参见音乐详情
{
"id": 7,
"created_at": "2017-04-17 15:27:59",
"updated_at": "2017-07-06 03:53:04",
"deleted_at": null,
"title": "umbrella",
"singer": {
"id": 2,
"created_at": "2017-03-16 17:22:18",
"updated_at": "2017-03-16 17:22:20",
"name": "佚名",
"cover": {
"id": 1,
"size": "370x370"
}
},
"storage": {
"id": 112
},
"last_time": 300,
"lyric": null,
"taste_count": 0,
"share_count": 0,
"comment_count": 0,
"has_like": true
},
{
"id": 3,
"created_at": "2017-03-16 17:21:09",
"updated_at": "2017-07-06 08:01:18",
"deleted_at": null,
"title": "别碰我的人",
"singer": {
"id": 1,
"created_at": "2017-03-16 17:22:04",
"updated_at": "2017-03-16 17:22:08",
"name": "群星",
"cover": {
"id": 1,
"size": "370x370"
}
},
"storage": { // 音乐付费时
"id": 133,
"amount": "200",
"type": "download",
"paid": "false",
"paid_node": "12"
},
"last_time": 200,
"lyric": null,
"taste_count": 297,
"share_count": 0,
"comment_count": 23,
"has_like": true
}
]
}
Not paid
{
"message": [
"请购买专辑"
],
"paid_node": 9, // 付费节点
"amount": 20 // 动态价格
}
增加专辑分享数
供移动端分享专辑时调用，统计专辑分享数
PATCH /music/specials/{special}/share
Response
Status: 204 No Content