验证身份验证 v4 令牌

驗證令牌¶

在成功登錄遊戲客戶端後，遊戲伺服器可以通過令牌、PlayerID 和 DID 在 PlayerInfo 回應值中驗證已登錄用戶的令牌密鑰的有效性。 因此，如果您的遊戲不允許重複登錄，請確保管理已驗證的令牌密鑰或從遊戲端管理會話密鑰以實現登錄功能。

• 請求 URL

  常見 URL	https://auth.qpyou.cn/game/token/get-token
  分佈式環境 URL	https://auth.globalwithhive.com/game/token/get-token
  沙盒 URL	https://sandbox-auth.qpyou.cn/game/token/get-token
  HTTP 方法	Post
  內容類型	text/html
  數據格式	JSON

• 請求 標頭

  字段名稱	描述	類型	是否必需
  授權	登錄後返回的令牌密鑰	字符串	是
  ISCRYPT	加密數據，0=未加密	整數	是

• 請求 主體

  欄位名稱	描述	類型	必填
  appid	用戶登錄的遊戲的 AppID	字串	是
  did	登錄後返回的 DID	字串	是
  player_id	登錄後身份驗證 v4 返回的 PlayerID	整數	是
  hive_certification_key	認證金鑰（由 AppCenter 發出） 查看更多	字串	否

• 回應

  欄位名稱	描述	類型
  result_code	驗證結果。0=成功 更多…	整數
  result_msg	結果訊息	字串

• Request Sample<

  { 
  "appid":"com.withhive",
  "did":"255764404509548", 
  "player_id": 21,
  "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
  }
  

• 回應 範例<

  { 
  "result_code":0,
  "result_message":"成功"
  }
  

• 錯誤 代碼

  值	描述
  0	成功
  2300	退款項目的要求償還
  4000	無效的參數
  4001	請求 json 錯誤
  4002	認證金鑰錯誤
  5000	資料庫錯誤
  5001	分散式環境中的無效令牌（AWS）
  6000	無效的 AppID
  6001	IdP 令牌錯誤
  7000	無效的令牌
  7001	標頭字段中沒有令牌
  9999	未知錯誤

驗證令牌，返回玩家 ID 的 IdP ID 列表¶

在成功登錄遊戲社區後，使用令牌、PlayerID、AppID 和 DID（Authorization 令牌、PlayerID 和 DID 在登錄後會在 PlayerInfo 中返回）來驗證已登錄用戶令牌的有效性，並獲取對應於 PlayerID 的 IdP ID 列表。

• 請求 網址

  商業伺服器網址	https://auth.qpyou.cn/server/player/get-idpuserid
  分散式環境網址	https://auth.globalwithhive.com/server/player/get-idpuserid
  沙盒網址	https://sandbox-auth.qpyou.cn/server/player/get-idpuserid
  HTTP 方法	Post
  內容類型	application/json
  數據格式	JSON

• 請求 標頭

  欄位名稱	描述	類型	是否必填
  授權	成功登入後返回的令牌	字串	Y
  ISCRYPT	加密資料，0=未加密	整數	Y

• 請求 主體

  字段名稱	描述	類型	是否必填
  appid	用戶登錄的遊戲的 AppID	字符串	是
  did	成功登錄後返回的 DID	字符串	是
  player_id	成功登錄後返回的 PlayerID	整數	是

• Request Body Example

  {
      "player_id": 20000016588,
      "appid" : "com.com2us.hivesdk.normal.freefull.google.global.android.common",
      "did" : 303581410
  }
  

• 回應 主體

  欄位名稱	描述	類型
  result_code	驗證結果， 0: 成功 4000: 參數值無效。 7000: 驗證失敗。驗證令牌值不匹配。	整數
  result_msg	結果訊息	字串
  data	結果資料	JSON

• 回應 主體 - data

  欄位名稱	描述	類型
  data.list	結果資料列表	陣列
  data.list.player_id	請求主體中請求的PlayerID	字串
  data.list.idp_user_id	從IdP傳遞的帳戶令牌 (uid)	字串
  data.list.idp_index	idp_index 1: HIVE 2: Facebook 3: GOOGLE 9: APPLE	字串

• Response Body Sample<

  {
          "result_code": 0,
          "result_msg": "成功",
          "data": {
                  "list": [
                          {
                                  "player_id": "20000016588",
                                  "idp_user_id": "68101398",
                                  "idp_index": "1"
                          }
                  ]
          }
  }