加载登录页面 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	字符串	param 字符串值是通過對下面表格中鍵值組成的 JSON 數據進行 URL 編碼和 BASE64 編碼創建的。	Y

• 查詢 參數 - param

  欄位名稱	類型	描述
  appid	字串	Hive 伺服器使用的應用程式 ID
  gindex	字符串	由 Hive 服务器使用的游戏索引信息。 App Center > Game List > 搜索你的游戏 and click it > Click the AppID tab > 点击游戏的AppID > Check 基本信息标签以获取游戏索引。
  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
  

• 回應 主體

  返回在API請求中提供的重定向URL，並附加“res”作為查詢參數。請參見下面的描述以了解res的解釋。

  字段名稱	描述	類型	是否必需
  URL	在API請求中提供的重定向URL，並附加“res”作為查詢參數	字符串	Y

• 回應 範例<

  // 如果 https://community.withhive.com/hivesdk/login/redirect 被設置為重定向 URL
  https://community.withhive.com/hivesdk/login/redirect?res=JTdCJTIyY29kZSUyMiUzQSUyMjEwMCUyMiUyQyUyMnN0YXRlJTIyJTNBJTIyMTY4ODEwODkyNzk0Mi1CUHVxcHFFaUd6S0lIJTIyJTdE
  

• 回應 主體 - res

  res 是通過將下面的鍵值組成的 JSON 對象轉換為字符串，使用 URL 編碼和 BASE64 編碼獲得的。要使用 JSON 對象，請先進行 BASE64 解碼，然後進行 URL 解碼。下面顯示了 JSON 對象。

  字段名稱	描述	類型
  code	回應代碼 (100: 成功)	字符串
  state	在驗證 v2 中使用的令牌	字符串

• 回應 範例 - res<

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