资源类型：其他教程
What’s New?
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=****************&
format=json
3.4返回参数说明
| 参数说明 | 描述 |
|---|---|
| ret | 返回码 |
| msg | 如果ret<0，会有相应的错误信息提示，返回数据全部用UTF-8编码。 |
| 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的100×100的头像，但40×40像素则是一定会有。 |
| gender | 性别。 如果获取不到则默认返回”男” |
| is_yellow_vip | 标识用户是否为黄钻用户（0：不是；1：是）。 |
| vip | 标识用户是否为黄钻用户（0：不是；1：是） |
| yellow_vip_level | 黄钻等级 |
| level | 黄钻等级 |
| is_yellow_year_vip | 标识是否为年费黄钻用户（0：不是； 1：是） |
3.5返回码说明
0: 正确返回
其它: 失败。错误码说明详见：【QQ登录】公共返回码说明。
3.6正确返回示例
JSON示例:
Content-type: text/html; charset=utf-8
{
“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”:”男”,
“is_yellow_vip”:”1″,
“vip”:”1″,
“yellow_vip_level”:”7″,
“level”:”7″,
“is_yellow_year_vip”:”1″
}
3.7错误返回示例
Content-type: text/html; charset=utf-8
{
“ret”:1002,
“msg”:”请先登录”
}
