Plus (ThinkSNS+)

Plus (ThinkSNS+)

  • 文档 [New]
  • 文档
  • REST API v2
  • 反馈
  • GitHub

›音乐

基本

  • 概述
  • 启动信息
  • Json Web Token 授权
  • 验证码
  • 位置
  • 标签
  • 消息通知
  • 钱包(旧版本)
  • Plus Pay(新钱包-支付工具)
  • 支付能力
  • 文件
  • 关于我们
  • 广告
  • 举报
  • 积分
  • 环信
  • 评论
  • 文件存储

用户

  • 用户
  • 注册
  • 收到的评论
  • 收到的喜欢
  • 关注
  • 标签
  • 身份认证
  • 找人
  • 排行榜
  • 反馈
  • 打赏用户
  • 未读消息
  • 签到
  • 消息

动态

  • 发布动态
  • 获取动态
  • 删除动态
  • 设置评论收费
  • 评论
  • 喜欢
  • 收藏
  • 置顶
  • 打赏
  • 排行榜
  • 举报
  • 积分部分新增接口
  • 话题

音乐

  • 音乐
  • 专辑
  • 点赞
  • 评论
  • 收藏

问答

  • 概述
  • 话题
  • 问题
  • 评论
  • 回答
  • 回答 · 打赏
  • 回答 · 围观
  • 用户 · 关注问题
  • 用户 · 喜欢回答
  • 用户 · 收藏回答
  • 用户 · 申请精选
  • 排行榜
  • 举报
  • 问答部分积分相关新增接口

资讯

  • 概述
  • 分类
  • 投稿
  • 获取
  • 评论
  • 喜欢
  • 打赏
  • 置顶
  • 收藏
  • 排行榜
  • 举报
  • 资讯部分积分相关新增接口

圈子

  • 概述
  • 分类
  • 圈子
  • 圈子 · 管理
  • 圈子 · 举报
  • 圈子 · 成员
  • 帖子
  • 帖子 · 评论
  • 帖子 · 喜欢
  • 帖子 · 收藏
  • 帖子 · 打赏
  • 帖子 · 置顶
  • 圈子部分积分相关新增接口
Edit

专辑

  • 专辑列表
  • 已购买的专辑列表
  • 专辑详情
  • 增加专辑分享数

专辑列表

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
← 音乐点赞 →
  • 专辑列表
  • 已购买的专辑列表
    • Parameters
  • 获取专辑详情
  • 增加专辑分享数
Plus (ThinkSNS+)
More
GitHubStar
Copyright © 2019 Chengdu ZhiYiChuangXiang Technology Co., Ltd. All rights reserved.