加载登录页面 v2

加载登录页面 v2¶

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

• 请求 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=JTdCJTIyY29kZSUyMiUzQSUyMjEwMCUyMiUyQyUyMnN0YXRlJTIyJTNBJTIyMTY4ODEwODkyNzk0Mi1CUHVxcHFFaUd6S0lHJTIyJTdE
  

• 响应 主体 - res

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

  字段名称	描述	类型
  code	响应代码 (100: 成功)	字符串
  state	在验证 v2 中使用的令牌	字符串

• 响应 示例 - res<

  {
          "code": "100",
          "state": "1627881984263-jkx1B3GOY3EsJ"
  }