蓝钻接入API列表
5.3 /v3/relation/get_app_friends
获取关系链，包括用户IM及QQGame好友
5.3.1 URL
//[域名/IP]/v3/relation/get_app_friends
5.3.2 格式
JSON
5.3.3 HTTP请求方式
GET
5.3.4 IP限制
TRUE
5.3.5 输入参数说明
| 参数 | 类型 | 含义 | 可选/必选 |
|---|---|---|---|
| appid | int | 详见公共参数说明部分 | 必选 |
| openid | string | 详见公共参数说明部分 | 必选 |
| openkey | string | 详见公共参数说明部分 | 必选 |
| sig | string | 详见公共参数说明部分 | 必选 |
| pf | string | 详见公共参数说明部分 | 必选 |
| seq | int | 回传字段 | 可选 |
5.3.6 请求事例
//113.108.20.23/relation/get_app_friends?openid=000000000000000000000000032373DF&
openkey=39DBE00A043F8DB011391759A3A8A250A453B88C079C516CB4AAC0F4691C931F3679B97D0A61560569095307220E4D2210DE35F24BF630F25DE6A290994A8735&
appid=28240&
pf=qqgame&
sig=e3evlGSde+JQ0AodlAn5RoX6InA=
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 二者同时为好友输出3 |
5.3.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}]}
"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}]}
5.3.8 错误返回示例
参见公共错误返回示例