总体流程

准备工作

明确是对接暗账号登录的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授权页面。

授权成功后返回 token 和 k 歌 openID。

微信

跳转至微信授权页面。

授权成功后返回 token。

全民K歌

跳转至K歌标准授权流程。

授权成功后返回 token。

用户进行上述授权操作。

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

相关接口介绍

获取暗账号绑定信息

给第三方提供应用提供外部接口，查询暗账号是否已经绑定

请求url

请求方式：POST

正式环境url：https://api.kg.qq.com/api/v2/get_virtual_bind_info

测试环境url：https://api.kg.qq.com/test/api/v2/get_virtual_bind_info

请求参数

参数类型：Content-Type: application/json

参数名	必选	类型	说明
appid	是	string	第三方应用appid
virtual_openid	是	string	暗账号openid
access_token	是	string	应用级的access_token

返回参数

参数名	类型	说明
status	int	绑定状态：1代表已经绑定，0代表未绑定
error_code	int	错误代码 (0=无错误)
error_msg	string	错误信息

暗账号解绑K歌uid

请求url
正式环境：https://api.kg.qq.com/api/v2/virtual_unbind

测试环境：https://api.kg.qq.com/test/api/v2/virtual_unbind

请求参数

参数类型：Content-Type: application/json

参数名	必选	类型	说明
appid	是	string	第三方应用appid
openid	是	string	暗账号openid
access_token	是	string	暗账号的access_token
token	是	string	第三方应用的auth_code

返回参数

参数名	类型	说明
error_code	int	错误码
error_msg	string	error_code非0时的错误消息

错误码

错误码	说明
0	成功
1503	未知错误
3001	参数无效或者参数不完整
3005	过期
3007	授权码无效
3010	未知获权类型
3013	应用或者秘钥无效

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

总体流程#

准备工作#

具体流程#

1. 用户发起绑定请求#

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

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

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

相关接口介绍#

获取暗账号绑定信息#

暗账号解绑K歌uid#