常见问题

1. 正式环境接口和测试环境接口有什么区别？

正式环境接口访问的是我们正式环境的接口，速度更快，服务也更稳定。测试环境接口访问的是我们环境，方便与接入方进行联调，解决接入过程中遇到的问题。测试环境的写数据和正式环境也是隔离的，方便接入方进行调试。此外，测试环境和正式环境的access_token是不同的，测试环境需要使用测试环境的access_token。

2. 如何调用测试环境的接口？

无论是开放平台授权api接口，亦或是K歌业务接口，都是在正式环境url的域名“api.kg.qq.com”后加一个“/test”。

3. 调用业务接口时，传了参数却不能正确解析

业务接口的body解析方式为json，所以需要业务方将请求的Content-Type设为“application/json”，并且以正确json的格式传递请求参数，只有这样我们的业务后台才能正确的解析到参数，否则都解析成默认值，有可能就会返回“参数错误”的结果。接口还需要注意是POST接口还是GET接口，否则可能会返回404。

4. token的有效期是多久？

acess_token的有效期是两个小时。
refresh_token的有效期是一个月。
每次获取的token都是新的token，会覆盖前面的token，导致前面的token失效。在开发过程中务必保证正确的获取和更新token。

5. 歌单歌曲怎么配置？

运营同学会提供已有的歌单类型和ID，厂商可以根据自己需求选择调用。也可以提供歌单歌曲mid列表，整理成文档线下发送个K歌运营同学新建和修改。

6. 目前有哪些歌单？

目前有用户推荐歌单、排行榜、自建歌单、标签歌单、主题歌单、专辑歌单。
https://docs.qq.com/sheet/DWHNISUZJekFwVmJZ?tab=jhqgxw

7. 首页歌单展示分类列表调用哪个接口？

客户端首页歌单运营配置由厂商具体负责，厂商需要搭建自己的运营配置后台，根据已有的歌单，选取适用的歌单配置客户端个性化展示内容。

8. 热门歌手通过哪个接口获取？

可以通过热⻔推荐接口：https://apifox.com/apidoc/project-951819/api-20441460

9. 全部歌手通过哪个接口获取？

可以通过搜索接口获取：https://apifox.com/apidoc/project-951819/api-25890497

10. 排行榜更新时间？

排行榜更新时间默认为每天更新，总数为100，目前没有返回榜单的更新时间。

11. 年代、语种、专题歌单在哪个接口获取？

这些属于主题歌单，可以在文档中分类专题中查找需要的歌单
https://docs.qq.com/sheet/DWHNISUZJekFwVmJZ?tab=jhqgxw

12. 文档中有多个歌单相关接口，应该用哪个？

推荐使用综合歌单接口，https://apifox.com/apidoc/project-951819/api-80018235
如果目前歌单类型不满足，则使用对应的专用接口。

1. 正式环境接口和测试环境接口有什么区别？#

2. 如何调用测试环境的接口？#

3. 调用业务接口时，传了参数却不能正确解析#

4. token的有效期是多久？#

5. 歌单歌曲怎么配置？#

6. 目前有哪些歌单？#

7. 首页歌单展示分类列表调用哪个接口？#

8. 热门歌手通过哪个接口获取？#

9. 全部歌手通过哪个接口获取？#

10. 排行榜更新时间？#

11. 年代、语种、专题歌单在哪个接口获取？#

12. 文档中有多个歌单相关接口，应该用哪个？#