验证身份验证 v4 令牌

验证令牌¶

在成功登录游戏客户端后，游戏服务器可以通过令牌、PlayerID 和 DID 在 PlayerInfo 响应值中验证已登录用户的令牌密钥的有效性。 因此，如果您的游戏不允许重复登录，请确保管理已验证的令牌密钥或从游戏端管理会话密钥以实现登录功能。

• 请求 URL

  常见 URL	https://auth.qpyou.cn/game/token/get-token
  分布式环境 URL	https://auth.globalwithhive.com/game/token/get-token
  沙盒 URL	https://sandbox-auth.qpyou.cn/game/token/get-token
  HTTP 方法	Post
  内容类型	text/html
  数据格式	JSON

• 请求 头部

  字段名称	描述	类型	是否必需
  授权	登录后返回的令牌密钥	字符串	是
  ISCRYPT	加密数据，0=未加密	整数	是

• 请求 主体

  字段名称	描述	类型	是否必填
  appid	用户登录的游戏的 AppID	字符串	是
  did	登录后返回的 DID	字符串	是
  player_id	登录后认证 v4 返回的 PlayerID	整数	是
  hive_certification_key	认证密钥（由 AppCenter 发布） 查看更多	字符串	否

• 响应

  字段名称	描述	类型
  result_code	验证结果。0=成功 更多…	整数
  result_msg	结果消息	字符串

• 请求 示例<

  { 
  "appid":"com.withhive",
  "did":"255764404509548", 
  "player_id": 21,
  "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
  }
  

• 响应 示例<

  { 
  "result_code":0,
  "result_message":"成功"
  }
  

• 错误 代码

  值	描述
  0	成功
  2300	退款商品的必要偿还
  4000	无效参数
  4001	请求json错误
  4002	认证密钥错误
  5000	数据库错误
  5001	分布式环境中的无效令牌（AWS）
  6000	无效的AppID
  6001	IdP令牌错误
  7000	无效令牌
  7001	头字段中没有令牌
  9999	未知错误

验证令牌，返回玩家ID的IdP ID列表¶

在成功登录游戏社区后，使用令牌、PlayerID、AppID和DID（Authorization令牌、PlayerID和DID在登录后会在PlayerInfo中返回）来验证已登录用户令牌的有效性，并获取与PlayerID对应的IdP ID列表。

• 请求 URL

  商业服务器 URL	https://auth.qpyou.cn/server/player/get-idpuserid
  分布式环境 URL	https://auth.globalwithhive.com/server/player/get-idpuserid
  沙盒 URL	https://sandbox-auth.qpyou.cn/server/player/get-idpuserid
  HTTP 方法	Post
  内容类型	application/json
  数据格式	JSON

• 请求 头部

  字段名称	描述	类型	是否必填
  Authorization	成功登录后返回的令牌	字符串	是
  ISCRYPT	加密数据，0=未加密	整数	是

• 请求 主体

  字段名称	描述	类型	是否必填
  appid	用户登录的游戏的 AppID	字符串	是
  did	成功登录后返回的 DID	字符串	是
  player_id	成功登录后返回的 PlayerID	整数	是

• Request Body Example<

  {
      "player_id": 20000016588,
      "appid" : "com.com2us.hivesdk.normal.freefull.google.global.android.common",
      "did" : 303581410
  }
  

• 响应 主体

  字段名称	描述	类型
  result_code	验证结果， 0: 成功 4000: 参数值无效。 7000: 验证失败。验证令牌值不匹配。	整数
  result_msg	结果消息	字符串
  data	结果数据	JSON

• 响应 主体 - data

  字段名称	描述	类型
  data.list	结果数据列表	数组
  data.list.player_id	请求主体中请求的PlayerID	字符串
  data.list.idp_user_id	从IdP传递的账户令牌（uid）	字符串
  data.list.idp_index	idp_index 1: HIVE 2: Facebook 3: GOOGLE 9: APPLE	字符串

• Response Body Sample

  {
          "result_code": 0,
          "result_msg": "成功",
          "data": {
                  "list": [
                          {
                                  "player_id": "20000016588",
                                  "idp_user_id": "68101398",
                                  "idp_index": "1"
                          }
                  ]
          }
  }