v3/music/get_list

调用本接口前,请按照模版提交API接口权限申请(申请方式详见这里),以获取接口调用权限。

目录

1 功能说明

为支持某些有音乐PK功能的应用能获取到腾讯方提供的音乐片段的需求,特别提供本接口。
应用通过调用本接口可获取到腾讯音乐数据库中的歌曲列表以及歌曲信息,例如:歌曲总数,歌曲列表,歌曲ID,歌手名,歌曲片段数等。
调用本接口获取到歌曲信息后,可以调用接口v3/music/get_clip来获得指定的歌曲片段url,从而实现为用户播放指定歌曲片段的功能。

接口调用限制:
本接口目前支持空间平台和朋友平台。

2 接口调用说明

2.1 URL

http://[域名]/v3/music/get_list

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
page 必须 string 需要获取第几页的音乐信息(从第1页开始)。

2.6 请求示例

http://openapi.tencentyun.com/v3/music/get_list?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
pf=qzone&
format=json&
userip=112.90.139.30&
page=1&
sig=9999b41ad0b688530bb1b21c5957391c

2.7 返回参数说明

参数名称 描述
ret 返回码。

公共返回码详见:公共返回码说明#OpenAPI V3.0 返回码

msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

all_count 数据库中所有的歌曲数。
cur_page 音乐信息所在的页,与输入的参数“page”值一致。
items 歌曲的详细信息列表。
song_id 歌曲ID。
song_name 歌曲名称。
singer 歌手名。
part_count 歌曲的片段数。每个片段的时长为10秒

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
  "ret":0,   
  "is_lost":0,     
  "all_count":10000,
  "cur_page": 2,
  "items":[
         {
           "song_id":12345,   
           "song_name":"北京欢迎你",  
           "singer":"群星",  
           "part_count":4  			
           }  
         {
           "song_id":12356,   
           "song_name":"趁早",  
           "singer":"张宇",  
           "part_count":4  			
           }  
            ]     
} 

2.9 错误返回示例

Content-type: text/html; charset=utf-8
{
  "ret":1002,
  "msg":"请先登录" 
}

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部