空间H5游戏-后台接口

/v3/user/get_info

pf=qzone pf=wanba_ts pf=weixin

获取登录用户的信息,包括昵称、头像、性别等信息。

本接口是全平台通用的,即发送请求后,可根据请求中传入的“pf”平台参数返回对应平台的用户信息,详见返回字段说明。

例如:如果传入的pf为qzone,则返回的是其QQ空间的昵称和头像。

空间小游戏使用pf值必须指定为wanba_tsweixin

注意

  1. 本接口返回的各种VIP(例如黄钻等)信息是经过缓存的,有一定的延时。

    如果需要VIP信息特别准确的场景(例如黄钻每日礼包场景中,非黄钻用户开通黄钻后,返回应用应该立即可领取礼包),请调用专门的VIP实时信息获取接口。

    目前为黄钻提供专门的黄钻实时信息获取接口:v3/user/is_vip,其它VIP实时信息获取接口为:v3/user/total_vip_info。

  2. 本接口只返回用户基本个人资料。对于其它更丰富的用户个人资料,出于保护用户隐私的考虑,目前尚不开放。

  3. 对于微信平台(pf=weixin),获取到的用户头像URL,最后一个数值代表正方形头像大小(有0、46、64、96、132数值可选,0代表640*640正方形头像),用户没有头像时该项为空。若用户更换头像,原有头像URL将失效。

URL

https://api.urlshare.cn/v3/user/get_info

私有参数

参数名称 是否必须 类型 描述
charset string 指定请求及响应的字符集,取值为gbk或utf-8(只有pf=qqgame或pf=3366时,可以输入该参数)。
默认值为utf-8,其他非法取值也认为是utf-8。
flag unsigned int pf=qqgame时,必须输入该参数,指定需要获取QQGame中的哪些信息:
1:需要获取游戏昵称和性别;
2:需要获取蓝钻等级;
3:需要获取昵称和蓝钻等级;
4:需要获取照片秀标志。

请求示例

https://api.urlshare.cn/v3/user/get_info?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
sig=VrN%2BTn5J%2Fg4IIo0egUdxq6%2B0otk%3D&
pf=wanba_ts&
format=json&
userip=112.90.139.30

返回参数说明

参数名称 支持的pf平台 描述
ret 全部 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 全部 如果错误,返回错误信息。
is_lost 全部 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。
0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。
nickname 全部 昵称
gender 全部 性别
country qzone、pengyou、qplus、weixin 国家
province qzone、pengyou、qplus、weixin 省份
city qzone、pengyou、qplus、weixin 城市
figureurl 全部 用户头像URL地址。
openid qplus 用户QQ号码转化得到的ID
qq_level qplus 用户QQ等级
qq_vip_level qplus 用户QQ会员等级
qplus_level qplus 用户Q+等级
is_yellow_vip qzone、pengyou、qplus 是否为黄钻用户(0:不是; 1:是)。
is_yellow_year_vip qzone、pengyou、qplus 是否为年费黄钻用户(0:不是; 1:是)。
yellow_vip_level qzone、pengyou、qplus 黄钻等级,目前最高级别为黄钻8级(如果是黄钻用户才返回此参数)。
is_yellow_high_vip qzone、pengyou、qplus 是否为豪华版黄钻用户(0:不是; 1:是)。
is_blue_vip qqgame、3366 是否为蓝钻用户(0:不是; 1:是)。
is_blue_year_vip qqgame、3366 是否为年费蓝钻用户(0:不是; 1:是)。
blue_vip_level qqgame、3366 蓝钻等级(如果是蓝钻用户才返回此参数)。
3366_level 3366 3366用户的大等级。
3366_level_name 3366 3366用户的等级名,如小游游、小游仙。
3366_grow_level 3366 3366用户的成长等级。
3366_grow_value 3366 3366用户的成长值。
is_super_blue_vip qqgame、3366 是否是豪华蓝钻。
cover qzone、wanba_ts 空间封面

错误返回码说明

本接口私有错误返回码:暂无。

正确返回示例

{
"ret":0,
"is_lost":0,
"nickname":"Peter",
"gender":"男",
"country":"中国",
"province":"广东",
"city":"深圳",
"figureurl":"http://imgcache.qq.com/qzone_v4/client/userinfo_icon/1236153759.gif",
"is_yellow_vip":1,
"is_yellow_year_vip":1,
"yellow_vip_level":7,
"is_yellow_high_vip": 0
}