QQ游戏开放平台

>资料库>接入指引

接入wiki索引

/v3/relation/get_app_friends

获取关系链，包括用户IM及QQGame好友

1.1.1 URL

//[域名/IP]/v3/relation/get_app_friends

1.1.2 格式

JSON

1.1.3 HTTP请求方式

GET

1.1.4 IP限制

TRUE

1.1.5 输入参数说明

参数名称	类型	参数含义	可选/必选
appid	int	详见公共参数说明部分	必选
openid	string	详见公共参数说明部分	必选
openkey	string	详见公共参数说明部分	必选
sig	string	详见公共参数说明部分	必选
pf	string	详见公共参数说明部分	必选
charset	string	指定请求及响应的字符集, 可选取值为gbk和utf-8, 默认值为gbk, 其他非法取值也认为是gbk	可选
seq	int	回传字段	可选

1.1.6 请求示例

//113.108.20.23/relation/get_app_friends?openid=000000000000000000000000032373DF&openkey=39DBE00A043F8DB011391759A3A8A250A453B88C079C516CB4AAC0F4691C931F3679B97D0A61560569095307220E4D2210DE35F24BF630F25DE6A290994A8735&appid=28240&pf=qqgame&sig=e3evlGSde+JQ0AodlAn5RoX6InA=

返回参数说明

参数名称	类型	含义
ret	int	详见公共返回码
msg	string	错误描述
seq	int	回传字段
items	array	关系链数组
items.openid	int	好友的openid
items.nickname	string	qq昵称
items.gender	string	性别“男”或“女”
items.figureurl	string	头像地址
items.is_blue_vip	bool	是否蓝钻，是返回true，否则false
items.blue_vip_level	int	蓝钻等级
items.is_blue_year_vip	bool	是否年费蓝钻，是返回true，否则false
items.is_super_blue_vip	bool	是否豪华蓝钻，是返回true，否则false
items.is_played	bool	是否玩过当前游戏，是返回true，否则false
items.friend_type	int	好友类型游戏好友为2，im好友为1 二者同时为好友输出2

1.1.7 正确返回示例

{
"ret":0,
"msg":"操作成功！",
"uin":0,
"seq":0,
"items":[{
"openid":"0000000000000000000000000003EEFD",
"nickname":"花满楼 ",
"gender":"男",
"figureurl":"//qqgameplatcdn.qq.com/social_hall/face_icon/24-1.png",
"is_blue_vip":false,
"blue_vip_level":0,
"friend_type":1}]
}

1.1.8 错误返回示例

参见公共错误返回示例