音乐 Api V2

音乐 Api V2

scope: music_basic_r

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

scope: douban_basic_common

name	Method	endpoint
发表新评论	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	查询的 tag	q 和 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]
}