文档中心 > API类目 > 音螺音乐

xiami.api.mltp.music.playinfo (播放信息获取)

提供音螺平台的音乐播放信息获取,支持源声/歌词(若有)/副歌(若有)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
play_info_get MusicPlayInfoGetDto 必须 系统自动生成
  • └ extra_id
  • String
  • 可选
  • 1231231
  • 合作方使用当前音乐的业务对象id
  • └ user_id
  • String
  • 可选
  • 21312123
  • 合作方账号体系内的用户id
  • └ music_id
  • String
  • 必须
  • 1b9avjclfj7l8vi
  • 音螺音乐id

响应参数

名称 类型 示例值 描述
result HsfResponse 结果
  • └ msg_code
  • String
  • 错误码
  • └ msg
  • String
  • 错误信息
  • result_obj
  • MusicPlayInfoDto
  • 结果对象
  • └ refrain_url
  • String
  • 副歌url
  • └ lrc_url
  • String
  • 逐行歌词url
  • └ listen_file_url
  • String
  • 歌曲源声url
  • └ status
  • String
  • 状态

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XiamiApiMltpMusicPlayinfoRequest req = new XiamiApiMltpMusicPlayinfoRequest();
XiamiApiMltpMusicPlayinfoRequest.MusicPlayInfoGetDto obj1 = new XiamiApiMltpMusicPlayinfoRequest.MusicPlayInfoGetDto();
obj1.setExtraId("1231231");
obj1.setUserId("21312123");
obj1.setMusicId("1b9avjclfj7l8vi");
req.setPlayInfoGet(obj1);
XiamiApiMltpMusicPlayinfoResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xiami_api_mltp_music_playinfo_response>
    <result>
        <msg_code></msg_code>
        <msg></msg>
        <result_obj>
            <refrain_url></refrain_url>
            <lrc_url></lrc_url>
            <listen_file_url></listen_file_url>
        </result_obj>
        <status></status>
    </result>
</xiami_api_mltp_music_playinfo_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

返回
顶部