取得 IDP 清單

應用程式伺服器可以使用應用程式用戶端登入成功後回傳的 PlayerID 和 AppID，搜尋與遊戲連結的 IdP 清單。應用程式伺服器直接實作此 API，以透過伺服器對伺服器方式搜尋清單。

Request 包含 AppId 和 PlayerID 作为基本参数，成功的 Response 通过一组变量在 Data 下输出 IdP 信息，具体取决于与 PlayerID 连接的 IdP 数量。

請求 URL

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

Note

身份驗證 v4 由分散式環境組成，以應對網絡連接故障或其他錯誤。如果因為任何錯誤問題導致網絡連接超時，請調用分散式環境 URL.

請求標頭

欄位名稱 描述類型 是否必填

ISCRYPT 資料是否加密 (0=未加密) 整數 Y (始終發送 0)

請求主體

字段名稱	描述	類型	必需
appid	用戶登錄的遊戲的 AppID	字符串	是
player_id	登錄後身份驗證 v4 返回的 PlayerID	大整數	是
hive_certification_key	證書密鑰（由 AppCenter 發出）查看更多	字符串	否

Request Sample<

    { 
        "appid":"com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
        "player_id": 90000000062,
        "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
    }

回應主體

欄位名稱	描述	類型	值
result_code	搜索結果	整數	0
result_msg	結果訊息	字串	0
data		JSON
data.seq	玩家的主鍵 (PK)	大整數	14
data.player_id	玩家ID	大整數	12
data.idp_user_id	由IdP提供的用戶ID	字串
data.idp_index	唯一的IdP索引	字串
data.idp_id	IdP標識符	字串	HIVE, FACEBOOK ...

Request Sample<

{ 
"appid":"com.withhive",
"did":"255764404509548", 
"player_id": 21

}

回應範例<

{
"result_code": 0,
"result_msg": "成功",
"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"
    }
]
}

結果代碼

值描述

0 成功

2002 沒有用戶數據存在

4000 無效的參數

4002 認證密鑰錯誤

idp_index

idp_index	idp_id	描述
0	GUEST	未通过 IdP 认证的玩家
1	HIVE	HIVE
2	FACEBOOK	Facebook
3	GOOGLE	Google (Play Games Services)
4	QQ	QQ
5	WEIBO	微博
6	VK	VK
7	WECHAT	微信
8	APPLE	Apple 游戏中心
9	SIGNIN_APPLE	Apple 登录
10	LINE	Line
12	WEVERSE	Weverse

值	描述
0	成功
2002	沒有用戶數據存在
4000	無效的參數
4002	認證密鑰錯誤

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