QQ游戏开放平台

欢迎来到QQ游戏开放平台 登录| 管理中心 | 开发者论坛

/v3/user/get_info

目录

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

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


1 URL

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

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明


2 格式

JSON


3 HTTP请求方式

GET


4 IP限制

TRUE


5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)公共参数

发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称
类型
参数含义
可选/必选
charset
string
指定请求及响应的字符集, 可选取值为gbk和utf-8, 默认值为gbk, 其他非法取值也认为是gbk
可选
seq
int
透传字段,应用传入后,平台原样返回
可选

6 请求示例

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


7 返回参数说明

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

8 正确返回示例

JSON示例:

{

    "ret":0,

    "msg":"操作成功!",

    "nickname":"1212 ",

    "gender":"男",

    "figureurl":"http://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

}


9 错误返回示例

参见公共错误返回示例


联系我们 向上
回到顶部