搜索鉴权 v4 IdP 列表

游戏服务器可以通过使用玩家ID和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 发布）查看更多	字符串	否

请求示例<

    { 
        "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 ...

请求示例<

{ 
"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": "访客"
    },
    {
    "seq": 10000000068,
    "player_id": 90000000062,
    "idp_user_id": "64646595",
    "idp_index": 1,
    "idp_id": "蜂巢"
    }
]
}

结果代码

值描述

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)