QQ互联API列表
API列表
| 分组名称 | 适用平台 | API接口 | 功能说明 | 备注 |
|---|---|---|---|---|
| 访问用户资料 | 网站、移动 | get_user_info | 获取登录用户的昵称、头像、性别 | |
| 访问用户QQ会员信息 | 网站、移动 | get_vip_info | 获取QQ会员的基本信息 | 需要申请 |
| get_vip_rich_info | 获取QQ会员的高级信息 | |||
| 访问我的空间相册 | 网站、移动 | list_album | 获取用户QQ空间相册列表 | 需要申请 |
| upload_pic | 上传一张照片到QQ空间相册 | |||
| add_album | 在用户的空间相册里，创建一个新的个人相册 | |||
| list_photo | 获取用户QQ空间相册中的照片列表 | |||
| 访问我的腾讯微博资料 | 网站、移动 | get_info | 获取登录用户在腾讯微博详细资料 | |
| 分享内容到我的腾讯微博 | 网站、移动 | add_t | 发表一条微博 | |
| del_t | 删除一条微博 | |||
| add_pic_t | 发表一条带图片的微博 | |||
| get_repost_list | 获取单条微博的转发或点评列表 | |||
| 获得我的微博好友信息 | 网站、移动 | get_other_info | 获取他人微博资料 | |
| get_fanslist | 我的微博粉丝列表 | |||
| get_idollist | 我的微博偶像列表 | |||
| add_idol | 收听某个微博用户 | |||
| del_idol | 取消收听某个微博用户 | |||
| 访问我的财付通信息 | 网站、移动 | get_tenpay_addr | 在这个网站上将展现您财付通登记的收货地址 | 需要申请 |
特别声明：
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 |
| 支持验证方式 | oauth2.0 |
| 格式 | JSON |
| http请求方式 | GET |
| 是否需要鉴权 | 需要 |
| 接口调试 | 点击这里测试 |
3.2输入参数说明
调用所有OpenAPI时，除了各接口私有的参数外，所有OpenAPI都需要传入基于OAuth2.0协议的通用参数：
| 参数 | 含义 |
|---|---|
| access_token | 可通过使用Authorization_Code获取Access_Token 或来获取。access_token有3个月有效期。 |
| 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":"请先登录" }
