v3/relation/is_friend

特别提示
为保护用户数据,仅hosting模式的应用(即将应用部署在腾讯云平台上的应用)才能调用本接口。

目录

1 功能说明

验证是否平台好友,即验证fopenid是否是openid的好友。
-腾讯朋友的好友范畴是指在腾讯朋友平台加为好友的人。
-腾讯微博的好友范畴是指在腾讯微博上互相收听的人。
-QQ空间、3366和QQGame平台的好友范畴是指在QQ客户端加为好友的人。

2 接口调用说明

2.1 URL

http://[域名]/v3/relation/is_friend

正式环境域名或测试环境IP详见:API3.0文档#请求URL说明

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

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

(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
charset string 指定请求及响应的字符集,取值为gbk或utf-8(只有pf=qqgame或pf=3366时,可以输入该参数)。

默认值为utf-8,其他非法取值也认为是utf-8。

fopenid 必须 string 待验证的好友QQ号码转化得到的ID。

2.6 请求示例

http://113.108.20.23/v3/relation/is_friend?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
sig=9999b41ad0b688530bb1b21c5957391c&
pf=qzone&
format=json&
userip=112.90.139.30&
fopenid=2C64A93789A0E1E191FF2B2107C4D4B1

2.7 返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码
msg 如果错误,返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache,不需要关心此参数。

0或者不返回:没有数据丢失,可以缓存。
1:有部分数据丢失或错误,不要缓存。

is_friend 是否为好友(0: 不是好友; >=1: 是好友)。

当pf=qqgame或pf=3366时,表示是否为QQ好友。

is_gamefriend 是否为QQGame好友(0: 不是QQGame好友; >=1: 是QQGame好友)。

(只有pf=qqgame时,返回此参数)

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8
{
"ret":0,
"is_lost":0,
"is_friend":1
}

2.9 错误返回示例

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

3 示例代码

详见:SDK下载#OpenAPI V3.0 SDK下载

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部