moe.fm/listen/playlist 电台音乐播放列表

获取萌否电台的音乐播放列表。

URL

支持格式

JSON

HTTP请求方式

GET

认证方式

  • API Key 认证
  • OAuth 认证

请求参数

参数名 说明
page 页数,默认为 1。
perpage 每页曲目数,默认为 9。取值范围为 [1, 30]。
fav 返回用户已收藏的音乐,可选为 music、song、radio,分别对应已收藏的专辑、曲目及个人电台。
music 返回指定 id 的专辑,多个 id 以半角逗号隔开,如 music=426,573,921。(id 指 wiki_id)
song 返回指定 id 的曲目,多个 id 以半角逗号隔开,如 song=4416,7571,9351。(id 指 sub_id)
radio 返回指定 id 的个人电台,多个 id 以半角逗号隔开,如 radio=347,908,214。(id 指 wiki_id)

注意事项

  • 以上参数均为选填,当不输入 fav、music、song、radio 参数时,则返回系统默认的乱序音乐播放列表。
  • 当指定 music、song 或 radio 参数时,可能因曲目过多而产生分页,此时 page 参数有效。
  • 当指定 fav 参数时,music、song、radio 参数均无效化。
  • music、song、radio 参数可混搭,如 music=7880&song=4416 将返回 7880 号专辑的曲目及 4416 号曲目。

返回结果

{
  "response":{
    "information":{
      "parameters":{
        "api":"json",
        "api_key":"5437a3faab348793353dcb9a7a34cb5e04edb8679"
      },
      "msg":[ ],
      "has_error":false,
      "request":"\/listen\/playlist?api=json&api_key=5437a3faab348793353dcb9a7a34cb5e04edb8679",
      "page":1, // 当前页数
      "item_count":9, // 本页曲目数
      "is_target":false, // 是否获得目标曲目。若指定了 music 等参数,且本页内包含此曲目,则为 true
      "may_have_next":true, // 下一页是否可能包含目标曲目
      "next_url":"http:\/\/moe.fm\/listen\/playlist?" // 获取下一页的网址
    },
    "playlist":[
      {
        "up_id":"15754",
        "url":"http:\/\/moefm.b0.upaiyun.com\/9\/8\/dc\/fcb2bb0bfd189ef715b10ee94a22e9b3.mp3", // 曲目 mp3 音乐地址
        "stream_length":"267", // 曲目时长(单位秒)
        "stream_time":"04:27", // 曲目时长(格式化)
        "file_size":"1925", // mp3 文件大小
        "file_type":"mp3",
        "wiki_id":9335, // 曲目所属专辑的 wiki_id
        "wiki_type":"music",
        "cover":{ // 专辑的封面
          "small":"http:\/\/nyan.moefou.org\/wiki_cover\/000\/00\/93\/000009335_96.jpg",
          "medium":"http:\/\/nyan.moefou.org\/wiki_cover\/000\/00\/93\/000009335_144.jpg",
          "square":"http:\/\/nyan.moefou.org\/wiki_cover\/000\/00\/93\/000009335_192.jpg",
          "large":"http:\/\/nyan.moefou.org\/wiki_cover\/000\/00\/93\/000009335.jpg"
        },
        "title":"song.03 \u904b\u547d\u306e\u5206\u304b\u308c\u9053", // 曲目标题(带曲号)
        "wiki_title":"Mysterious Circle", // 专辑标题
        "wiki_url":"http:\/\/moe.fm\/music\/9335", // 专辑网址
        "sub_id":75122, // 曲目的 sub_id
        "sub_type":"song",
        "sub_title":"\u904b\u547d\u306e\u5206\u304b\u308c\u9053", // 曲目标题(不带曲号)
        "sub_url":"http:\/\/moe.fm\/song\/75122", // 曲目网址
        "artist":"\u77e2\u4f4f\u590f\u83dc", // 曲目表演者
        "fav_wiki":null, // 当前登录用户是否有收藏该专辑,若有则为 fav 对象
        "fav_sub":null // 当前登录用户是否有收藏该曲目,若有则为 fav 对象
      },
      ... ... // 省略显示其他曲目
    ]
  }
}
moe.fm/api/listen/playlist.txt · 最后更改: 2015-01-09 22:32 (外部编辑)