跳到主要内容

登录

前言

在阅读下文之前，请先阅读基本功能概述，了解后端回调接口的基本流程与签名规则。

获取用户登录令牌

平台请求游戏方的回调接口，消息类型为 AUTH_KEY ，请求体包含游戏 ID、用户 ID、区服 ID（可选）。游戏方需要根据这些参数，返回一个 auth_key ，这是用户在平台进入游戏的登录令牌。

平台不关心 auth_key 的具体内容，平台会在前端打开游戏时将 auth_key 传给游戏方，游戏方需要根据 auth_key 判断用户登录态的有效性。

请求示例

{
  "notify_type": "AUTH_KEY",
  "timestamp": 1624529209,
  "version": "v2",
  "sign_type": "MD5",
  "sign": "20386d447256c1b3310d7274b74c0f25",
  "body": {
    "user_id": "700098915",
    "game_id": "119121100",
    "server_id": ""
  }
}

请求参数说明

参数	类型	长度限制	示例	说明
user_id	string		700098915	平台的用户 ID
game_id	string	255	119121100	平台的游戏 ID
server_id	string	255		游戏方提供的游戏区服 ID（跨端内选服忽略此参数）

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "auth_key": "e277dd1e05688a22e377e25a3dae5de1",
    "ext": ""
  }
}

响应参数说明

参数	类型	长度限制	示例	说明
auth_key	string	255		游戏方提供的用户访问令牌，有效时间建议 30-60 分钟
ext	string	255		游戏方提供额外数据，将会在打开游戏时作为参数透传

获取用户登录令牌