分享到 :

get_user_info

What's New?

2013年5月，网站和移动应用都可以调用本接口。用户信息字段增加了QQ头像字段。
2012年9月20日，新增返回参数"is_yellow_year_vip"，支持获取用户是否年费黄钻的信息。

1.接口说明

获取登录用户在QQ空间的信息，包括昵称、头像、性别及黄钻信息（包括黄钻等级、是否年费黄钻等）。

2.使用场景

此接口主要用于网站使用QQ登录时，直接拉取用户在QQ空间的昵称、头像、性别等信息，降低用户的注册成本。

3.接口调用说明

3.1请求说明

url https://graph.qq.com/user/get_user_info
支持验证方式 oauth2.0
格式 JSON
http请求方式 GET
是否需要鉴权 需要
接口调试 点击这里测试

3.2输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738。
（1）通用参数
-OAuth2.0协议必须传入的通用参数，详见这里

3.3请求示例

以OAuth2.0协议为例（敏感信息都用*号进行了处理，实际请求中需要替换成真实的值）：

https://graph.qq.com/user/get_user_info?
access_token=*************&
oauth_consumer_key=12345&
openid=****************

3.4返回参数说明

注：以下标红返回参数非真实数据，详见这里

参数说明 描述
ret 返回码
msg 如果ret<0，会有相应的错误信息提示，返回数据全部用UTF-8编码
is_lost 判断是否有数据丢失。如果应用不使用cache，不需要关心此参数。0或者不返回：没有数据丢失，可以缓存。1：有部分数据丢失或错误，不要缓存
nickname 用户在QQ空间的昵称。
figureurl 大小为30×30像素的QQ空间头像URL。
figureurl_1 大小为50×50像素的QQ空间头像URL。
figureurl_2 大小为100×100像素的QQ空间头像URL。
figureurl_qq_1 大小为40×40像素的QQ头像URL。
figureurl_qq_2 大小为100×100像素的QQ头像URL。需要注意，不是所有的用户都拥有QQ的100x100的头像，但40x40像素则是一定会有。
gender 性别。 如果获取不到则默认返回"男"
gender_type 性别类型。默认返回2
province 省
city 市
year 年
constellation 星座
is_yellow_vip 标识用户是否为黄钻用户
yellow_vip_level 黄钻等级
is_yellow_year_vip 是否为年费黄钻用户

 

3.5返回码说明

0: 正确返回
其它: 失败。错误码说明详见：公共返回码说明。

3.6正确返回示例

JSON示例:

{
"ret":0,
"msg":"",
"nickname":"Peter",
"figureurl":"http://qzapp.qlogo.cn/qzapp/111111/942FEA70050EEAFBD4DCE2C1FC775E56/30",
"figureurl_1":"http://qzapp.qlogo.cn/qzapp/111111/942FEA70050EEAFBD4DCE2C1FC775E56/50",
"figureurl_2":"http://qzapp.qlogo.cn/qzapp/111111/942FEA70050EEAFBD4DCE2C1FC775E56/100",
"figureurl_qq_1":"http://q.qlogo.cn/qqapp/100312990/DE1931D5330620DBD07FB4A5422917B6/40",
"figureurl_qq_2":"http://q.qlogo.cn/qqapp/100312990/DE1931D5330620DBD07FB4A5422917B6/100",
"gender":"男"
}

3.7错误返回示例

 { "ret":1002, "msg":"请先登录" }

4.相关问题

你可以直接通过我们的常见问题查看更多问题或提问，也可以直接联系我们的在线客服800013811

返回顶部