使用認證 API 查詢使用者資訊

透過身份驗證 API 獲取用戶信息 是在完成網頁登錄後，需要單獨檢查用戶信息時請求的 API。

根據來自登錄驗證和用戶信息檢索 API的響應值appid、idp_index和idp_user_id返回對應於IdP的用戶信息。

請求 URL¶

環境	URL
生產	https://auth.qpyou.cn/game/player/get-playerid
生產	https://auth.globalwithhive.com/game/player/get-playerid
沙盒	https://sandbox-auth.qpyou.cn/game/player/get-playerid
HTTP 方法	POST
內容類型	application/json

Note

身份验证 v4 旨在创建一个分布式环境，以应对故障或网络通信问题。如果故障或网络通信异常超过为游戏服务器定义的通信超时，则必须调用分布式环境 URL。

請求標頭¶

欄位名稱	類型	描述	是否必填
ISCRYPT	整數	資料是否加密 (0: 未加密)	Y

請求主體¶

欄位名稱	類型	描述	必填
appid	字串	應用程式 ID	Y
idp_index	整數	IdP 索引 `1`: Hive `2`: Facebook `3`: Google `9`: Apple	Y
idp_user_id	字串	IdP 唯一識別碼	Y
hive_certification_key	字串	Hive 認證金鑰 (Hive 控制台 > 應用程式中心 > 專案管理 > 遊戲詳細資訊 > 基本資訊 > Hive 認證金鑰)	Y

請求主體範例¶

{
  "appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common",
  "idp_index": 1,
  "idp_user_id": "68101398",
  "hive_certification_key": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
}

回應主體¶

欄位名稱	類型	描述	備註
result_code	整數	結果代碼
result_msg	字串	結果訊息
data	JSON	結果數據
data.enc_idp	字串	用於加密請求主體信息的密鑰	用於PC上的外部自動登錄的一次性令牌
data.player_id	大整數	玩家ID
data.list	陣列	連結的IdP列表	包含用戶連結的IdP信息的列表
data.list.seq	大整數	連結的IdP列表 - 序列	僅在身份驗證中使用的序列鍵
data.list.player_id	大整數	連結的IdP列表 - 玩家ID
data.list.idp_user_id	字串	連結的IdP列表 - IdP的唯一標識符
data.list.idp_index	整數	連結的IdP列表 - IdP索引	`1`: Hive `2`: Facebook `3`: Google `9`: Apple
data.list.idp_id	字串	連結的IdP列表 - IdP ID	即使使用其他IdP遊玩，GUEST也會默認創建
data.is_blocked	布林值	用戶是否被封鎖	`true`: 被封鎖的用戶 `false`: 正常用戶
data.is_refund	布林值	用戶是否需重新支付退款	`true`: 需重新支付退款的用戶 `false`: 不需重新支付退款的用戶

結果代碼¶

result_code	描述
0	成功
2002	沒有用戶數據
4000	無效的請求參數

回應主體範例 (用戶資訊存在)¶

{
  "result_code": 0,
  "result_msg": "SUCCESS",
  "data": {
    "enc_idp": "K+A4xduO7kf5OrJ/iDPqL0PtMxwu7wW8JSBO+JJwSDDmJLvIi/6LG7TyWXdEHr9RNHM+/QXwc0+Y9z2eSRg7oeBBHmpOajzF1iiaacbFom4CsNy2fItendset7T0i0WYdyLQih3z5mDjcct47+gg2ovbp6kWRY8D+aGq+ZgaKiyr0Hmb1xmbWY/7cl1FjXTm0Nl9CWhO418bJFdwOpi+bw==",
    "player_id": 20000016588,
    "list": [
      {
        "seq": 25771,
        "player_id": 20000016588,
        "idp_user_id": "68101398",
        "idp_index": 1,
        "idp_id": "HIVE"
      },
      {
        "seq": 25772,
        "player_id": 20000016588,
        "idp_user_id": "0",
        "idp_index": 0,
        "idp_id": "GUEST"
      }
    ],
    "is_blocked": false,
    "is_refund": false
  }
}

回應主體範例 (無用戶資訊)¶

{
  "result_code": 2002,
  "result_msg": "No User",
  "data": {
    "enc_idp": "K+A4xduO7kf5OrJ/iDPqLyCHfP+L3wz0WTNVw5KHLCqYjqQ+shQ2P3mkgwYCMvlnPatzlSE5ZFINr5gEIxK14sg0N8kOPSjSCeQ9UGGt11OMrYsGTuys0KmPJ2ZU/UWVVxpP1Lxx1eS8VbYwLmoTG+HTw2vkocghs/ZOZ9rqisdBRprhp6Q6+lIjpaUzDa2yy2guM1WheuVzKGL5331HHgo557RqoyUzTc6Lkf8ArWZ/XSwi3ZmStmhz/U4thcIwiowqgV+Ecdb2+WmMZ1MgGT4Xvbxa4lqzToBC3nxDvi1d8TjgMaszVYoNct94WPBGvV6emg3GqiJG+0ZTGg53+mZad9ttkUpTnQXetz5UDTxe5NnFAYfffzBq3jkqfAB042eH21rE3uTVJq3HuO8i9t1LJwKFfkC7sjjuaKNWsjs="
  }
}

回應主體範例 (失敗)¶

{
  "result_code": 4000,
  "result_msg": "Request has invalid format.",
  "data": "appid, idp_user_id, idp_index"
}