get_app_friends

特别声明

出于信息安全的考虑,本接口仅对可信赖的合作移动应用开放。
已经成功接入“QQ登录”的移动应用需提交申请以获取访问OpenAPI的权限。

目录

1 接口说明

获取已安装了移动应用的好友信息,包括OpenID、昵称、QQ空间头像、QQ头像。

1.1 URL

https://graph.qq.com/user/get_app_friends

1.2 格式

JSON

1.3 HTTP请求方式

GET

1.4 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738

(1)通用参数
OAuth2.0协议必须传入的通用参数,详见这里

(2)私有参数
format: 定义API返回的数据格式。
取值说明:为xml时表示返回的格式是xml;为json时表示返回的格式是json。
注意:json、xml为小写,否则将不识别。format不传或非xml,则返回json格式数据。

1.5 请求示例

https://graph.qq.com/user/get_app_friends?
access_token=1234ABD1234ABD&
oauth_consumer_key=12345&
openid=B08D412EEC4000FFC37CAABBDC1234CC&
format=json

1.6 返回参数说明

参数名称 描述
ret 返回码。

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

msg 如果ret<0,会有相应的错误信息提示,返回数据全部用UTF-8编码。
items 获取到的好友信息列表。
openid 好友的OpenID。
nickname 好友昵称。
figureurl 大小为30×30像素的好友QQ空间头像URL。
figureurl_1 大小为50×50像素的好友QQ空间头像URL。
figureurl_2 大小为100×100像素的好友QQ空间头像URL。
figureurl_qq 大小为100×100像素的QQ头像URL。

1.7 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret":0,
"msg":"",
"items":[

  {
    "openid":"9CE729C9927532BABBB57F6AB000925B",
    "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":"http://q.qlogo.cn/qqapp/111111/942FEA70050EEAFBD4DCE2C1FC775EF0/100"
   },
  {
    "openid":"08B8273CACFBE0D9F57CAB4E7D8BDBF0",	
    "nickname":"Tom",
    "figureurl":"http://qzapp.qlogo.cn/qzapp/111111/08B8273CACFBE0D9F57CAB4E7D8BDBF0/30",
    "figureurl_1":"http://qzapp.qlogo.cn/qzapp/111111/08B8273CACFBE0D9F57CAB4E7D8BDBF0/50",
    "figureurl_2":"http://qzapp.qlogo.cn/qzapp/111111/08B8273CACFBE0D9F57CAB4E7D8BDBF0/100",
    "figureurl_qq":"http://q.qlogo.cn/qqapp/111111/08B8273CACFBE0D9F57CAB4E7D8BDBF0AE/100"
   }	
 ]

}

1.8 错误返回示例

Content-type: text/html; charset=utf-8
{
"ret":1002,
"msg":"请先登录"
}

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部