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
nickname
figureurl
figureurl_1
figureurl_2
返回码
如果 ret<0,会有相应的错误信息提示,返回数据全部用
UTF-8 编码。
用户在 QQ 空间的昵称。
大小为 30×30 像素的 QQ 空间头像 URL。
大小为 50×50 像素的 QQ 空间头像 URL。
大小为 100×100 像素的 QQ 空间头像 URL。
figureurl_qq_1
大小为 40×40 像素的 QQ 头像 URL。
figureurl_qq_2
大小为 100×100 像素的 QQ 头像 URL。需要注意,不是所有
的用户都拥有 QQ 的 100x100 的头像,但 40x40 像素则是一
定会有。
gender
性别。 如果获取不到则默认返回"男"
is_yellow_vip
标识用户是否为黄钻用户(0:不是;1:是)。
vip
标识用户是否为黄钻用户(0:不是;1:是)
yellow_vip_level 黄钻等级
level
黄钻等级
is_yellow_year_vip 标识是否为年费黄钻用户(0:不是; 1:是)
3.5 返回码说明
0: 正确返回
其它: 失败。错误码说明详见:公共返回码说明。
3.6 正确返回示例
JSON 示例:
Content-type: text/html; charset=utf-8
{
"ret":0,
"msg":"",
"nickname":"Peter",
"figureurl":"http://qzapp.qlogo.cn/qzapp/111111/942FEA70050EEAFBD4DCE
2C1FC775E56/30",
"figureurl_1":"http://qzapp.qlogo.cn/qzapp/111111/942FEA70050EEAFBD4D
CE2C1FC775E56/50",
"figureurl_2":"http://qzapp.qlogo.cn/qzapp/111111/942FEA70050EEAFBD4D
CE2C1FC775E56/100",
"figureurl_qq_1":"http://q.qlogo.cn/qqapp/100312990/DE1931D5330620DBD
07FB4A5422917B6/40",
"figureurl_qq_2":"http://q.qlogo.cn/qqapp/100312990/DE1931D5330620DBD
07FB4A5422917B6/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":"请先登录"
}