全民K歌IOT开放平台
  1. 开放平台接入指南
全民K歌IOT开放平台
  • 厂商合作流程
  • 快速接入
  • SDK bug提单规范
  • 如何在线调试接口
  • 常见问题FAQ
  • 业务错误码说明
  • 开放平台接入指南
    • 登录鉴权方式介绍V2(推荐)
    • 如何申请接入
    • CDK权限申请流程
    • 暗账号绑定明账号对接文档
    • 获取应用级token
      POST
    • 获取登录二维码
      POST
    • 查询二维码的状态
      POST
    • 获取用户级token
      POST
    • 刷新用户级token
      POST
  • 基础类
    • tagId对照表
    • 歌曲详情
      POST
    • 查询mv的播放地址
      POST
    • 搜索
      POST
    • 搜索联想
      POST
    • 查询歌手歌曲
      POST
    • 获取歌曲歌词文件
      POST
    • Q音歌曲mid映射K歌
      POST
    • 短剧播放链接
      POST
    • 查询应用限免配置
      POST
    • 转换Q音或酷狗歌曲ID
      POST
  • 运营类
    • 排行榜id说明
    • 获取城市id列表
      GET
    • 获取专题分类列表
      POST
    • 获取云端配置
      POST
    • 热门ugc
      POST
    • 热搜词
      POST
    • 排行榜
      POST
    • 获取专题下歌曲信息
      POST
    • 获取车联渠道映射
      POST
    • 热门推荐
      POST
    • (新)排行榜
      POST
    • 综合歌单列表查询
      POST
    • 设置缓存设备
      POST
    • TV版分类歌单列表
      POST
    • 获取用户协议
      POST
    • 综合歌单列表查询(海外)
      POST
    • 榜单列表查询(海外)
      POST
    • 自建歌单列表查询(海外)
      POST
    • 获取广告配置
      POST
    • 拉取短剧合集的列表
      POST
  • 用户类
    • 用户信息查询
    • 删除用户UGC作品
    • 获取推荐/翻唱作品
    • 获取同城作品
    • 用户作品列表
    • 获取好友作品
    • UGC作品详情
    • 更改作品访问权限
    • 用户个推歌单
  • 支付类
    • 支付接入流程
    • 订单发货使用简述
    • 开通设备会员限免简述
    • 通用sign计算规则
    • 通用返回结构
    • 【CDK】CDK兑换
    • 【CDK】生成CDK
    • 【CDK】CDK召回
    • 【CDK】CDK状态查询
    • 【三方支付】订单发货
    • 【三方支付】手机号发货
    • 【三方支付】订单状态查询
    • 【米大师支付】获取会员商品列表
    • 【米大师支付】未登录-查询会员商品列表
    • 【米大师支付】支付下单
    • 【米大师支付】支付成功通知
    • 【米大师支付】查询用户支付成功订单记录
    • 查询设备以及用户是否有赠送资格
    • 查询设备限免剩余时长
    • 设备会员迁移
    • 查询会员赠送时长
    • 同步支付订单接口
    • 【三方支付】存量会员迁移领取查询
    • 【三方支付】存量会员迁移接口
    • 授权设备体验会员
    • 查询用户会员信息
    • 【三方支付】超会发货
    • 取消授权设备体验会员
  • 用户作品-文件类
    • callback_url说明
    • 上传音频源文件
    • (服务端)上传音频作品的链接
  • 通用类
    • 【厂商定制】匹配搜索
    • 获取kg的短链接
  1. 开放平台接入指南

暗账号绑定明账号对接文档

总体流程#

暗账号绑定明账号流程图.png

准备工作#

明确是对接暗账号登录的AppID
向@euphiekan(阚楚涵)申请开通AppID的"暗账号绑定明账号"权限

具体流程#

1. 用户发起绑定请求#

检查该暗账号是否已绑定明账号。(待定)
如已绑定,根据业务需求决定是否提示换绑。
如未绑定,进入授权流程。

2. 前端生成一个H5链接#

第三方应用的 auth_code(全民K歌暗账号登录方案中,该字段称为loginToken) + 第三方应用的 appid 生成一个H5链接。
正式环境:https://kg.qq.com/openAccountBind?appid=${appid}&auth_code=${auth_code}
测试环境:https://fastest.kg.qq.com/openAccountBind/?_tde_id=8286&appid=${appid}&auth_code=${auth_code}&exp=1
需要替换为暗账号的 appid 与 auth_code。

3. 引导用户在浏览器中打开H5链接#

可选择使用 QQ / 微信 / 全民K歌其中一种方式进行授权登录(以下为H5页面内部流程):
​QQ​
  跳转至QQ授权页面。
  授权成功后返回 token 和 k 歌 openID。
微信​
  跳转至微信授权页面。
  授权成功后返回 token。
全民K歌​
  跳转至K歌标准授权流程。
  授权成功后返回 token。
用户进行上述授权操作。

4. 跳回到H5页面,显示绑定成功#

修改于 2025-07-25 03:47:27
上一页
CDK权限申请流程
下一页
获取应用级token
Built with