v3/music/get_clip

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

目录

1 功能说明

为支持某些有音乐PK功能的应用能获取到腾讯方提供的音乐片段的需求,特别提供本接口。
应用通过调用接口v3/music/get_list获取到歌曲的相关信息后,可通过调用本接口获取指定歌曲片段的url。本接口支持批量获取,每次最多可获取20个歌曲片段的url。
当用户进入应用播放音乐时,即可通过本接口获取的url给用户播放歌曲片段。

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

2 接口调用说明

2.1 URL

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

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

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

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

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

(2)私有参数

参数名称 是否必须 类型 描述
song_ids 必须 string 需要获取的歌曲片段ID,多个ID之间用“_”分隔,每次最多可输入20个。

格式为<song_id>-<part_id>_<song_id>-<part_id>...,例如:1554114-1_1554114-2。
“song_id”:需要获取的歌曲片段对应的歌曲ID,通过接口/v3/music/get_list获取。
“part_id”:需要获取的歌曲片段的片段ID。取值范围为:1-“part_count”的值(该值通过接口/v3/music/get_list获取)。

2.6 请求示例

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

2.7 返回参数说明

参数名称 描述
ret 返回码。

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

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

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

items 歌曲片段的信息列表。
song_id 歌曲片段对应的歌曲ID。
part_id 歌曲片段的片段ID。
url 歌曲片段的url。

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
  "ret":0,   
  "is_lost":0,     
  "items":[
         {
           "song_id": 1554114, 
           "part_id": 1,
           "url":"http://xxxx.com/yyy1"         		
            },   
         {
           "song_id": 1554114, 
           "part_id": 2,
           "url":"http://xxxx.com/yyy2"         		
            }		   
          ]   
} 

2.9 错误返回示例

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

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

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部