跳轉至

加载登录页面 v1

載入登入頁面 v1

此 API 載入用戶實際可以登入的網頁登入的 URL 地址。當用戶登入後，應用開發者設置的重定向 URL、playerId 和用於邏輯驗證的授權令牌將被返回。支持的 IdP 帳戶包括 Hive、Google、Facebook 和 Apple 帳戶。

我們不建議在使用Hive SDK 開發應用程式時使用 Web Login V1 API。 這是因為PlayerID 包含遊戲記錄，如果用戶嘗試將他們之前使用 Web Login V1 登錄的帳戶與他們當前在遊戲中登錄的帳戶鏈接，可能會導致帳戶衝突。

Note

要使用 Web Login V1，您必須首先在 Hive 控制台 App Center 中完成相關設置，如下所示。欲了解更多詳情，請查看 控制台指南。

 

  • 請求 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”作為查詢參數 字符串 是
  • 回應 範例< 
    // 如果 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"
}