分组名称
适用平台
功能说明
备注
访问用户资料
网站、移动
获取登录用户的昵称、头像、性别
访问用户QQ会员信息
网站、移动
获取QQ会员的基本信息
需要申请
访问我的空间相册
网站、移动
获取用户QQ空间相册列表
需要申请
上传一张照片到QQ空间相册
在用户的空间相册里,创建一个新的个人相册
获取用户QQ空间相册中的照片列表
访问我的腾讯微博资料
网站、移动
获取登录用户在腾讯微博详细资料
分享内容到我的腾讯微博
网站、移动
发表一条微博
删除一条微博
发表一条带图片的微博
获得我的微博好友信息
网站、移动
获取他人微博资料
收听某个微博用户
取消收听某个微博用户
访问我的财付通信息
网站、移动
在这个网站上将展现您财付通登记的收货地址
需要申请
特别声明:
add_share和add_one_blog接口已于2014.3.31正式下线。请PC网站调用PC空间分享组件,移动端下载最新版本的SDK后调用shareToQQ或shareToQzone接口,以满足用户分享一条动态(feeds)到QQ空间的功能。
接口详解
以 get_user_info 为例,如有更新,请参考官方文档。
1、接口说明
获取登录用户在QQ空间的信息,包括昵称、头像、性别及黄钻信息(包括黄钻等级、是否年费黄钻等)。
2、使用场景
此接口主要用于网站使用QQ登录时,直接拉取用户在QQ空间的昵称、头像、性别等信息,降低用户的注册成本。
3、接口调用说明
3.1请求说明
url
https://graph.qq.com/user/get_user_info
格式
JSON
http请求方式
GET
是否需要鉴权
需要
3.2输入参数说明
调用所有OpenAPI时,除了各接口私有的参数外,所有OpenAPI都需要传入基于OAuth2.0协议的通用参数:
参数
含义
access_token
oauth_consumer_key
申请QQ登录成功后,分配给应用的appid
openid
用户的ID,与QQ号码一一对应。可通过调用https://graph.qq.com/oauth2.0/me?access_token=YOUR_ACCESS_TOKEN 来获取。
各个参数请进行URL 编码,编码时请遵守 RFC 1738。
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编码。
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
性别。 如果获取不到则默认返回"男"
is_yellow_vip
标识用户是否为黄钻用户(0:不是;1:是)。
vip
标识用户是否为黄钻用户(0:不是;1:是)
yellow_vip_level
黄钻等级
level
黄钻等级
is_yellow_year_vip
标识是否为年费黄钻用户(0:不是; 1:是)
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":"男",
"is_yellow_vip":"1",
"vip":"1",
"yellow_vip_level":"7",
"level":"7",
"is_yellow_year_vip":"1"
}
3.7错误返回示例
{ "ret":1002, "msg":"请先登录" }