常见问题FAQ

tips：有什么问题，可使用智能问答平台进行咨询。
https://developer.y.qq.com/kgAiChat

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

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

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

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

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

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

Q:4. token的有效期是多久？

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

Q:5. 歌单歌曲怎么配置？

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

Q:6. 目前有哪些歌单？

A:目前有用户推荐歌单、排行榜、自建歌单、标签歌单、主题歌单、专辑歌单。
https://doc.weixin.qq.com/sheet/e3_ATAAzgbRAAsCNjzb22PaKRp2s3Fpi?scode=AJEAIQdfAAouvRdH2ZATAAzgbRAAs&tab=BB08J2

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

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

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

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

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

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

Q:10. 排行榜更新时间？

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

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

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

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

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

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

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

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

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

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

Q:6. 目前有哪些歌单？#

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

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

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

Q:10. 排行榜更新时间？#

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

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