跳到主要内容

登录（接口鉴权）

鉴权方式

本章节内容使用的鉴权方式为 接口鉴权 ，请确认这是您想要的鉴权方式，详见选择鉴权方式。

一、后端对接​

请完成后端登录的接入，在后端实现 AUTH_KEY 接口后，再执行下一步操作。

若未实现 AUTH_KEY 接口就进行页面对接，页面会提示 AUTH_KEY 接口错误，而无法提供正确的游戏页面 URL。

二、前端对接​

游戏启动时，平台会调用游戏方的 AUTH_KEY 接口，接口会返回 auth_key 和 ext 参数。然后，平台会把 auth_key 和 ext 的值将作为 authKey 和 ext 参数拼接到游戏启动链接中。

游戏方通过获取链接中的 authKey 参数可以进行登录态校验，还可以通过 ext 参数进行额外的数据透传。

这一步骤对应上方时序图的 6、7、8 部分。

举个例子

游戏方提供的游戏启动链接为 https://a.b.c/game001

用户打开游戏时，实际的启动链接可能为

https://a.b.c/game001?server_id=12345678&authKey=demoauthkey&userId=12345678&ext='%7B%22key%22%3A%22value%22%7D'&xlData='%7B%22key%22%3A%22value%22%7D'&client=1

以下是游戏启动链接可能携带的参数：

参数类型必选说明
server_idstring否游戏的区服 ID，仅页游接入需要（区服 ID 后端来源）
authKeystring是游戏的用户访问令牌，用于作身份校验（authKey 后端来源）
userIdstring是平台的用户 ID（由平台提供）
extstring是游戏方的透传数据（ext 后端来源）
xlDatastring是平台的用户数据（由平台提供），查看数据结构
clientstring否平台的运行环境（由平台提供），1 表示浏览器，2 表示迅雷游戏客户端，目前仅 PC 游戏中心存在此字段