专辑

优质
小牛编辑
129浏览
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

名称类型描述
limitInteger可选,默认值 20 ,获取条数
max_idInteger可选,上次获取到数据最后一条 ID,用于获取该 ID 之后的数据。
idarray可选,批量获取专辑。

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