获取关系链，包括用户IM及QQGame好友
1 URL
https://[域名/IP]/v3/relation/get_app_friends
正式环境域名或测试环境IP详见：API3.0文档#请求URL说明。
2 格式
JSON
3 HTTP请求方式
GET
4 IP限制
TRUE
5 输入参数说明
各个参数请进行URL 编码，编码时请遵守 RFC 1738
（1）公共参数
发送请求时必须传入公共参数，详见公共参数说明。
（2）私有参数
|
参数名称 |
类型 |
参数含义 |
可选/必选 |
|
charset |
string |
指定请求及响应的字符集, 可选取值为gbk和utf-8, 默认值为gbk, 其他非法取值也认为是gbk |
可选 |
|
seq |
int |
透传字段，应用传入后，平台原样返回 |
可选 |
|
only_game_friends |
int | 该字段值为1时代表只返回玩过同一款游戏的好友 | 可选 |
|
figure_type |
int | 0为默认头像，1为40*40头像，2为40*40动态头像，3为100*100头像，4为140*140头像，5为原图头像 |
可选 |
6 请求示例
https://119.147.19.43/v3/relation/get_app_friends?openid=000000000000000000000000032373DF&openkey=39DBE00A043F8DB011391759A3A8A250A453B88C079C516CB4AAC0F4691C931F3679B97D0A61560569095307220E4D2210DE35F24BF630F25DE6A290994A8735&appid=28240&pf=qqgame&sig=e3evlGSde+JQ0AodlAn5RoX6InA=
7 返回参数说明
|
参数名称 |
类型 |
含义 |
|
ret |
int |
详见公共返回码 |
|
msg |
string |
错误描述 |
|
seq |
int |
回传字段 |
|
items |
array |
关系链数组 |
|
items.openid |
int |
好友的openid |
|
items.nickname |
bool |
qq昵称 |
|
items.gender |
bool |
性别“男”或“女” |
|
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，游戏关注人4，游戏黑名单8 二者同时为好友输出2 |
8 正确返回示例
{
"ret":0,
"msg":"操作成功！",
"uin":0,
"seq":0,
"items":[{
"openid":"0000000000000000000000000003EEFD",
"nickname":"花满楼 ",
"gender":"男",
"figureurl":"http://qqgameplatcdn.qq.com/social_hall/face_icon/24-1.png",
"is_blue_vip":false,
"blue_vip_level":0,
"friend_type":1}]
}
9 错误返回示例
参见公共错误返回示例