文档中心 > API类目 > 曲库开放平台歌曲API

xiami.content.music.audio.get (获取音乐音频信息)

(批量)获取音乐音频信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
song_audio_ids SongAudioIdDTO 必须 音频id
  • └ song_id
  • Number
  • 必须
  • 123
  • 歌曲id
  • └ audio_id
  • Number
  • 可选
  • 123
  • 音频id

响应参数

名称 类型 示例值 描述
result_code ResultCode 结果code
  • └ msg
  • String
  • success
  • 消息
  • └ code
  • Number
  • 123
  • code
audios ResultCode [] 音频信息
  • └ song_id
  • Number
  • 123
  • 歌曲id
  • audios
  • Integer []
  • 音频
  • └ audio_id
  • Number
  • 123
  • 音频id
  • └ duration
  • Number
  • 300000
  • 时长(毫秒)
  • └ listen_url
  • String
  • http://xxx/xxx.mp3
  • 播放地址
  • └ file_size
  • Number
  • 5999
  • 文件大小
  • └ format
  • String
  • mp3
  • 格式
  • └ rate
  • Number
  • 320
  • 码率
  • └ quality
  • Number
  • 1
  • 品质
  • └ sample_rate
  • Number
  • 32
  • 采样率
  • └ bits
  • Number
  • 64
  • └ expire
  • Number
  • 1607702400000
  • 过期时间
  • └ refrain_end_time
  • Number
  • 16000
  • 副歌结束时间(毫秒)
  • └ refrain_start_time
  • Number
  • 14000
  • 副歌开始时间(毫秒)
  • └ video_part_start_time
  • Number
  • 16000
  • 热门片段结束时间(毫秒)
  • └ video_part_end_time
  • Number
  • 14000
  • 热门片段开始时间(毫秒)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XiamiContentMusicAudioGetRequest req = new XiamiContentMusicAudioGetRequest();
XiamiContentMusicAudioGetRequest.SongAudioIdDTO obj1 = new XiamiContentMusicAudioGetRequest.SongAudioIdDTO();
obj1.setSongId(123L);
obj1.setAudioId(123L);
req.setSongAudioIds(obj1);
XiamiContentMusicAudioGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xiami_content_music_audio_get_response>
    <result_code>
        <msg>success</msg>
        <code>123</code>
    </result_code>
    <audios>
        <result_code>
            <song_id>123</song_id>
            <audios>
                <integer>
                    <audio_id>123</audio_id>
                    <duration>300000</duration>
                    <listen_url>http://xxx/xxx.mp3</listen_url>
                    <file_size>5999</file_size>
                    <format>mp3</format>
                    <rate>320</rate>
                    <quality>1</quality>
                    <sample_rate>32</sample_rate>
                    <bits>64</bits>
                    <expire>1607702400000</expire>
                </integer>
            </audios>
            <refrain_end_time>16000</refrain_end_time>
            <refrain_start_time>14000</refrain_start_time>
            <video_part_start_time>16000</video_part_start_time>
            <video_part_end_time>14000</video_part_end_time>
        </result_code>
    </audios>
</xiami_content_music_audio_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部