QQ游戏 开放平台

欢迎来到QQ游戏开放平台 管理中心 | 注册 | 开发者论坛
蓝钻接入API列表

5.1/v3/user/get_info

获取QQGame的登录用户信息,包括用户基本资料以及蓝钻级别等相关信息。

请避免使用该api作为判断用户登陆态的凭证,调用is_login判定用户登陆态,判定登陆 成功后即保证用户正常登陆,如果还有特权等需求,再调用此api拉取用户资料进行判定,避免get_info超时导致用户无法登陆。

5.1.1 URL

//[域名/IP]/v3/user/get_info

5.1.2 格式

JSON

5.1.3 HTTP请求方式

GET

5.1.4 IP限制

TRUE

5.1.5 输入参数说明

参数 类型 含义 可选/必选
appid int 详见公共参数说明部分 必选
openid string 详见公共参数说明部分 必选
openkey string 详见公共参数说明部分 必选
sig string 详见公共参数说明部分 必选
pf string 详见公共参数说明部分 必选
charset string 指定请求及响应的字符集, 可选取值为gbk和utf-8, 默认值为gbk, 其他非法取值也认为是gbk 可选
seq int 透传字段,应用传入后,平台原样返回 可选

5.1.6 请求事例

//113.108.20.23/user/get_info?
openid=000000000000000000000000032373DF&
openkey=39DBE00A043F8DB011391759A3A8A250A453B88C079C516CB4AAC0F4691C931F3679B97D0A61560569095307220E4D2210DE35F24BF630F25DE6A290994A8735&
appid=28240&
pf=qqgame&
sig=e3evlGSde+JQ0AodlAn5RoX6InA=

返回参数说明

参数 类型 含义
ret int 详见公共返回码
msg string 错误描述
nickname string 详见公共参数说明部分
sig string qq昵称
gender string 返回“男”或“女”
figureurl string 头像url,统一为qq默认头像,格式为png,大小为32*32px
is_blue_vip boolean 是否蓝钻,true代表是,false代表不是
is_blue_year_vip boolean 是否年费蓝钻,true代表是,false代表不是
blue_vip_level int 蓝钻等级
is_super_blue_vip boolean 是否豪华版蓝钻,true代表是,false代表不是

5.1.7 正确返回示例

{"ret":0,
"msg":"操作成功!",
"nickname":"1212 ",
"gender":"男",
"figureurl":"//qqgameplatcdn.qq.com/social_hall/face_icon/128-1.png",
"is_blue_vip":true,
"is_blue_year_vip":true,
"blue_vip_level":2,
"is_super_blue_vip":true}

5.1.8 错误返回示例

参见公共错误返回示例