空间H5游戏-后台接口
/v3/user/get_info
pf=qzone
pf=wanba_ts
pf=weixin
获取登录用户的信息,包括昵称、头像、性别等信息。
本接口是全平台通用的,即发送请求后,可根据请求中传入的“pf”平台参数返回对应平台的用户信息,详见返回字段说明。
例如:如果传入的pf为qzone,则返回的是其QQ空间的昵称和头像。
空间小游戏使用pf值必须指定为
wanba_ts
或weixin
注意
本接口返回的各种VIP(例如黄钻等)信息是经过缓存的,有一定的延时。
如果需要VIP信息特别准确的场景(例如黄钻每日礼包场景中,非黄钻用户开通黄钻后,返回应用应该立即可领取礼包),请调用专门的VIP实时信息获取接口。
目前为黄钻提供专门的黄钻实时信息获取接口:v3/user/is_vip,其它VIP实时信息获取接口为:v3/user/total_vip_info。
本接口只返回用户基本个人资料。对于其它更丰富的用户个人资料,出于保护用户隐私的考虑,目前尚不开放。
对于微信平台(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
}