使用身份验证 API 获取用户信息

通过身份验证 API 获取用户信息 是在完成网页登录后需要单独检查用户信息时请求的 API。

返回与 IdP 对应的用户信息，使用来自登录验证和用户信息检索 API 的响应值 appid、idp_index 和 idp_user_id。

请求 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	是
idp_index	整数	IdP 索引 `1`: Hive `2`: Facebook `3`: Google `9`: Apple	是
idp_user_id	字符串	IdP 唯一标识符	是
hive_certification_key	字符串	Hive 认证密钥 (Hive 控制台 > 应用中心 > 项目管理 > 游戏详情 > 基本信息 > Hive 认证密钥)	是

请求体示例¶

{
  "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`: 不需要退款的用户

结果代码¶

结果代码	描述
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"
}