音乐Api V2

回Api V2 首页

scope: music_basic_r

获取音乐信息GET/v2/music/:id
搜索音乐GET/v2/music/search
某个音乐中标记最多的标签GET/v2/music/:id/tags

scope: douban_basic_common

发表新评论POST/v2/music/reviews
修改评论PUT/v2/music/review/:id
删除评论DELETE/v2/music/review/:id
用户对音乐的所有标签GET/v2/music/user_tags/:id

音乐信息 Music

{   
    "id":10000037,
    "title":"我只在乎你",
    "alt":"http:\/\/music.douban.com\/music\/10000037",
    "author":[{"name":"邓丽君"}],
    "alt_title":"留聲經典復刻版",
    "tags":[
        {"count":20,"name":"经典"},
        {"count":20,"name":"邓丽君"}
    ],
    "summary": "邓丽君在1987年推出的唱片专集《我只在乎你》中,有三首歌的词作者是“桃丽莎”。其实,桃丽莎即是邓丽君自己(英文名TERESA的中译)。根据我手中的资料,邓丽君作的词并不多,虽然她确曾向媒体表示“最大的心愿是出一张一脚踢的唱片”——即由自己包办下全部的词曲和制作,但是因意外去世而没能实现。但是,在此专集中竟有三首之多,不能不令人关注。大体上说,这三首歌具有两种风格,一为写实,一为浪漫。《非龙非彲》以现代汉语与古汉语混合,歌词的意境悲凉,心态哀痛,而且隐含着非比寻常的寓意,笔者愿在此写出来就教于方家。",
    "image":"http:\/\/img1.douban.com\/spic\/s11185741.jpg",
    "mobile_link":"http:\/\/m.douban.com\/music\/subject\/10000037\/",
    "attrs":{
            "publisher":["环球"],
            "singer":["邓丽君"],
            "discs":["1"],
            "pubdate":["1987-01-02"],
            "title":["我只在乎你"],
            "media":["CD"],
            "tracks":["01. 酒醉的探戈\n02. 像故事般温柔\n03. 命运之川\n04. 爱人\n05. 午夜微风\n06. 夏日圣诞\n07. 非龙非彲\n08. 不着痕迹\n09. 心路过黄昏\n10. 我只在乎你"],
            "version":["专辑"]
    },
    rating":{"max":10,"average":"0.0","numRaters":20,"min":0},
}

评论信息 Review

{
    "rating":{"max":5,"value":"5","min":1},
    "updated":"2012-08-31 15:03:06",
    "author":User,
    "title":"再见,teresa",
    "votes":0,
    "comments":0,
    "summary":"今年是邓丽君小姐逝世15周年,北美歌迷在各地的华人社区举行了盛大的纪念仪式,而我所在的多伦多更是规模空前.1987年邓丽君的一首<<我只在乎你>...",
    "music":Music,
    "useless":0,
    "published":"2012-08-31 15:03:06",
    "alt":"http:\/\/music.douban.com\/review\/5567544\/",
    "id":5567544
}

标签信息 Tag

{
    "count":20,
    "alt":"http:\/\/api.douban.com\/tag\/经典",
    "title":"经典"
}

获取音乐信息

GET  https://api.douban.com/v2/music/:id

返回音乐信息,返回status=200

搜索音乐

GET  https://api.douban.com/v2/music/search
参数意义备注
q查询关键字q和tag必传其一
tag查询的tagq和tag必传其一
start取结果的offset默认为0
count取结果的条数

返回:返回status=200,

{
      "start": 0,
      "count": 10,
      "total": 30,
      "musics" : [Music, ]
    }

某个音乐中标记最多的标签

GET  https://api.douban.com/v2/music/:id/tags

返回:返回status=200,

{
      "start": 0,
      "count": 10,
      "total": 30,
      "tags" : [Tag, ]
    }

发表新评论

POST  https://api.douban.com/v2/music/reviews
参数意义备注
music评论所针对的music id必传
title评论头必传
content评论内容必传
rating打分

返回: 返回status=201, 音乐评论Review信息

修改评论

PUT  https://api.douban.com/v2/music/review/:id
参数意义备注
title评论头必传
content评论内容必传
rating打分

返回: status = 202, 音乐评论Review信息

删除评论

DELETE  https://api.douban.com/v2/music/review/:id

返回:返回status=200, OK

用户对音乐的所有标签

GET  https://api.douban.com/v2/music/user_tags/:id

返回:返回status=200,

{
      "start": 0,
      "count": 10,
      "total": 30,
      "tags" : [Tag, ]
    }