获取歌曲的歌词
描述
通过歌曲 ID 获取歌曲的整首歌词。
接口原型
- 请求方法:GET
- 请求地址:
https://ktv-api.zego.im/?Action=DescribeSongLyric
- 传输协议:HTTPS
- 调用频率限制:200 次/秒
请求参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 - 公共请求参数。
说明
在线 KTV 服务端接口的公共请求参数与实时音视频、实时语音的不同,包含了 VendorId(版权方 ID),请务必阅读上述参考文档。
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
SongId | String | 是 | 歌曲 ID。 |
请求示例
Untitled
https://ktv-api.zego.im/?Action=DescribeSongLyric
&SongId=125282604
&<公共请求参数>
1
响应参数
参数 | 类型 | 描述 |
---|---|---|
Code | Number | 返回码。 |
Message | String | 请求结果的说明信息。 |
RequestId | String | 请求 ID。 |
Data | Object | 响应结果,详情可见 Data。 |
Data
参数 | 类型 | 描述 |
---|---|---|
Lyric | String | 歌词。 |
响应示例
Untitled
{
"Code": 0,
"Message": "succeed",
"RequestId": "1a6d02a8-66ba-455f-9e05-fe77da6a1f14",
"Data": {
"Lyric": "•[id:$00000000]\r\n[ar:韩红]\r\n[ti:我和我的祖国]\r\n[by:]\r\n[hash:15568cf4d9db1faf260cf3a965017cd8]\r\n[al:]\r\n[sign:]\r\n[qq:]\r\n[total:248000]\r\n[offset:0]\r\n[00:00.77]韩红 - 我和我的祖国\r\n[00:03.25]作词:张藜\r\n[00:04.41]作曲:秦咏诚\r\n[00:24.67]我和我的祖国\r\n[00:30.07]一刻也不能分割\r\n[00:35.48]无论我走到哪里\r\n[00:41.00]都留下一首赞歌\r\n[00:46.40]我歌唱每一座高山\r\n[00:51.70]我歌唱每一条河\r\n[00:57.51]袅袅炊烟\r\n[00:59.89]小小村落\r\n[01:02.92]路上一道辙\r\n[01:09.07]我亲爱的祖国\r\n[01:15.64]我永远紧依着你的心窝\r\n[01:22.41]你用你那母亲的脉搏\r\n[01:27.87]和我诉说\r\n[01:58.18]我的祖国和我\r\n[02:03.28]像海和浪花一朵\r\n[02:08.89]浪是那海的赤子\r\n[02:14.25]海是那浪的依托\r\n[02:19.86]每当大海在微笑\r\n[02:25.12]我就是笑的旋涡\r\n[02:30.52]我分担着海的忧愁\r\n[02:36.09]分享海的欢乐\r\n[02:42.27]我亲爱的祖国\r\n[02:49.17]你是大海永不干涸\r\n[02:55.85]永远给我碧浪清波\r\n[03:01.40]心中的歌\r\n[03:07.60]我亲爱的祖国\r\n[03:14.23]你是大海永不干涸\r\n[03:21.16]永远给我碧浪清波心中的歌\r\n[03:32.48]永远给我碧浪清波心中的歌\r\n"
}
}
1
返回码
以下仅列出了接口业务逻辑相关的部分返回码,完整返回码请参考 全局返回码。
返回码 | 说明 | 处理建议 |
---|---|---|
320000004 | 参数非法。 | 请根据 Message 提示判断非法参数,调整对应参数值。 |
320010000 | AppId 不可用 | 请联系 ZEGO 技术支持开通版权音乐服务。 |
320010001 | 不支持的付费类型。 | 请联系 ZEGO 技术支持开通版权音乐对应的付费类型。
|
320050000 | 系统错误。 | 请联系 ZEGO 技术支持。 |
320050002 | 系统繁忙。 | 请稍后重试。 |
320050003 | 未定义的引擎错误。 | 请联系 ZEGO 技术支持。 |
320050004 | 引擎内部错误。 | 请联系 ZEGO 技术支持。 |