跳转至

加载登录页面 v1

加载登录页面 v1

此 API 加载用户实际可以登录的网页登录的 URL 地址。当用户登录时，应用开发者设置的重定向 URL、playerId 和用于逻辑验证的授权令牌将被返回。支持的 IdP 账户包括 Hive、Google、Facebook 和 Apple 账户。

我们不建议在使用Hive SDK开发应用时使用Web Login V1 API。 这是因为PlayerID包含游戏记录，如果用户尝试将他们之前通过Web Login V1登录的账户与他们当前在游戏中登录的账户链接，可能会导致账户冲突。

Note

要使用 Web 登录 V1，您必须首先在 Hive 控制台 应用中心 中完成相关设置，如下所示。有关更多详细信息，请查看 控制台指南。

 

  • 请求 URL
    商业服务器 URL https://weblogin.withhive.com/login?param=
    沙盒 URL https://sandbox-weblogin.withhive.com/login?param=
  • 请求 头
    HTTP 方法 GET
    内容类型 text/html
  • 查询 参数
    字段名称 类型 描述 必需
    param 字符串

    参数字符串值是通过对下面表格中键值组成的JSON数据进行URL编码和BASE64编码生成的。

    		 是
  • 查询 参数 - param
    字段名称 类型 描述
    appid 字符串 Hive 服务器使用的应用程序 ID
    gindex 字符串 游戏索引信息用于 Hive 服务器。 应用 中心 > 游戏 列表 > 搜索您的游戏 并 点击 它 > 点击 该 AppID 标签 > 点击游戏的AppID > 检查 基本信息标签以获取游戏索引。
    url 字符串 这是用户登录完成后重定向的URL地址。它应该与Hive控制台中设置的重定向URL相同。
    国家 字符串 游戏或社区设置的国家代码。如果未提供此值，则使用网页浏览器的默认值。
    语言 字符串 游戏或社区设置的语言代码。如果未提供此值，则使用网页浏览器的默认值。
  • 请求 示例< 
    // 原始参数由 JSON 对象组成。对该 JSON 对象进行 URL 编码和 BASE64 编码后获得的字符串值在调用 API 时用作查询参数。
{
        "appid":"com.com2us.hivesdk.ios.community.global.normal",
        "gindex":"539",
        "url":"https://community.withhive.com/hivesdk/login/redirect",
        "country":"KR",
        "language":"ko"
}

    // 调用 API，将编码的参数作为查询参数附加到请求 URL。
https://weblogin.withhive.com/login?param=JTdCJTIyYXBwaWQlMjIlM0ElMjJjb20uY29tMnVzLmhpdmVzZGsuaW9zLmNvbW11bml0eS5nbG9iYWwubm9ybWFsJTIyJTJDJTIyZ2luZGV4JTIyJTNBJTIyNTM5JTIyJTJDJTIydXJsJTIyJTNBJTIyaHR0cHMlM0ElMkYlMkZjb21tdW5pdHkud2l0aGhpdmUuY29tJTJGaGl2ZXNkayUyRmxvZ2luJTJGcmVkaXJlY3QlMjIlMkMlMjJjb3VudHJ5JTIyJTNBJTIyS1IlMjIlMkMlMjJsYW5ndWFnZSUyMiUzQSUyMmtvJTIyJTdE
  • Response Body

    返回在API请求中提供的重定向URL，并将“res”作为查询参数附加。有关res的解释，请参见下面的描述。

    字段名称 描述 类型 是否必需
    URL 在API请求中提供的重定向URL，附加“res”作为查询参数 字符串 是
  • 响应 示例< 
    // 如果将 https://community.withhive.com/hivesdk/login/redirect 设置为重定向 URL
https://community.withhive.com/hivesdk/login/redirect?res=JTdCJTIyY29kZSUyMiUzQSUyMjEwMCUyMiUyQyUyMnBpZCUyMiUzQSUyMjIwMDAwMDE0NTQ0JTIyJTJDJTIydG9rZW4lMjIlM0ElMjIxNjg4MTA5MDQ0NTgzLWpmNWJwUjY3MFVMSmhsQlpoVTlUN0IlMjIlN0Q=
  • 响应 主体 - res

    res是通过将下面的键值组成的JSON对象转换为字符串，并通过URL编码和BASE64编码获得的。要使用JSON对象，请进行BASE64解码，然后进行URL解码。下面显示了JSON对象。

    字段名称 描述 类型
    code 响应代码 (100: 成功) 字符串
    pid 由Hive服务器验证的玩家ID 字符串
    token 用于验证玩家ID的令牌 字符串
  • 响应 示例 - res< 
    {
        "code": "100",
        "pid": "20000009891",
        "token": "1627881984263-jkx1B3GOY3EsJ"
}