IdP 清單查詢¶

使用從應用程式用戶端成功登入後傳回的玩家 ID 和應用程式 ID，從應用程式伺服器擷取連結到玩家的 IdP（身分提供者）清單。「取得 IdP 清單」API 透過伺服器到伺服器通訊進行操作，其中應用程式伺服器直接呼叫 Hive 驗證伺服器。請求成功後，連結的 IdP 資訊將以陣列形式傳回回應的資料欄位。發起請求時，App ID 和 Player ID 為必填參數。

請求網址¶

生產網址	https://auth.qpyou.cn/v2/game/player/get-idp
分散式環境URL	https://auth.globalwithhive.com/v2/game/player/get-idp
沙箱網址	https://sandbox-auth.qpyou.cn/v2/game/player/get-idp
HTTP 方法	POST
Content-Type	application/json
資料格式	JSON

Note

Hive認證伺服器配置在分散式環境中，以應對故障或網路通訊不穩定的情況。
如果與認證伺服器主機通訊失敗，或超過應用程式伺服器定義的逾時時間，應用程式伺服器必須直接呼叫分散式環境URL（Fallback URL）。

請求頭¶

欄位名稱	描述	類型	必填
X-Access-Token	用於遊戲伺服器驗證的 OAuth 2.0 存取權杖（請參閱 OAuth 權杖核發）	String	Y
ISCRYPT	資料是否加密（0 = 未加密；始終傳遞 0）	Integer	Y

## 請求正文
欄位名稱	描述	類型	必填
---	---	---	---
appid	應用程式 ID	String	Y
player_id	登入成功後回傳的驗證玩家ID	BigInteger	Y

請求範例¶

{
    "appid": "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
    "player_id": 90000000062
}

響應體¶

欄位名稱	描述	類型
result_code	回應代碼詳情	Integer
result_msg	結果留言	String
token_validation	JWT 驗證結果 (JWT 驗證錯誤)	Object
token_validation.result_code	JWT驗證結果碼	Integer
token_validation.result_msg	JWT 驗證結果訊息	String
data	IdP 清單資料	Array
data[].seq	用戶主鍵（PK）	BigInteger
data[].player_id	玩家ID	BigInteger
data[].idp_user_id	IdP 提供的使用者 ID 值	String
data[].idp_index	IdP 唯一編號詳情	Integer
data[].idp_id	IdP 的字串值	String

結果碼¶

代碼值	描述
0	成功
2002	沒有用戶資料
4000	無效參數
2499	JWT 驗證失敗（請參閱 token_validation）

## 回應範例
### 成功
`{ "result_code": 0, "result_msg": "SUCCESS", "token_validation": { "result_code": 0, "result_msg": "success" }, "data": [ { "seq": 10000000067, "player_id": 90000000062, "idp_user_id": "0", "idp_index": 0, "idp_id": "GUEST" }, { "seq": 10000000068, "player_id": 90000000062, "idp_user_id": "64646595", "idp_index": 1, "idp_id": "HIVE" } ] }`

JWT 驗證失敗¶

{
    "result_code": 2499,
    "result_msg": "JWT validation failed. See token_validation for details.",
    "token_validation": {
        "result_code": 2408,
        "result_msg": "The access token is expired. Please refresh your token."
    }
}

Note

當JWT驗證失敗時，您可以在token_validation欄位中查看詳細的錯誤訊息。詳細資訊請參閱JWT 驗證錯誤代碼。

IdP 索引¶

有關 IdP 索引信息，請參閱 IdP 清單。