登录凭证校验

本接口应在服务器端调用，严禁在前端（APP 客户端、网页、小游戏等）直接调用，避免凭证泄露风险。

接口说明

接口英文名 auth.code2session

功能描述 登录凭证校验（code2session）。小游戏服务端使用登录时获取的 code 换取用户会话信息。

注意：本接口直接以标准 HTTPS 请求调用，不支持服务通信二次加密和签名。game_id、secret、code 等参数以明文 Query 形式传递，响应为标准 JSON 明文，无需构造加密报文、签名请求头或处理响应解密。

调用方式

HTTPS 调用

GET /v1/auth/code2session

调用时，请在接口路径前拼接游戏所属服务区域的基础地址，详见服务区域与接口地址。

请求参数 - Query

属性	类型	默认值	必填	说明
game_id	string		是	游戏id
secret	string		是	游戏secret
code	string		是	登录时获取的code
grant_type	string		是	授权类型，固定填写 authorization_code

返回值

返回的 JSON 数据包

属性	类型	说明
errcode	int32	错误码
errmsg	string	错误信息
session_key	string	会话密钥
openid	string	用户唯一标识
unionid	string	用户在游戏组下的唯一标识
legacy_user_identity	string	遗留用户标识信息
channel_id	int32	渠道id，0-其他，1-OPPO，2-HONOR，3-XIAOMI

调用示例

请求数据示例

GET /v1/auth/code2session?game_id=xxx&secret=xxx&code=xxx&grant_type=authorization_code

返回数据示例

{
  "errcode": 0,
  "errmsg": "ok",
  "session_key": "Wh/vJSqjuUvFiX7Zaecgrw==",
  "openid": "176587c7ae606feb7d837852b17e7d76",
  "unionid": "9e8d7a9f9c0d581b57f131583e1702b8",
  "legacy_user_identity": "xxx",
  "channel_id": 1
}