v3/relation/get_rcmd_friends

调用本接口前,请按照模版提交API接口权限申请(申请方式详见这里),以获取接口调用权限。

1. 应用DAU(日活跃用户)大于10000,才可以申请本接口调用权限。
2. 如果应用在用户刚进入应用,就使用确认框的模式让用户邀请好友(详见fusion2.dialog.invite),需要申请本接口的权限时,腾讯方将不予通过。

目录

1 功能说明

开发者在使用推广渠道等接口时,如果需要为用户推荐选择的好友,或开发者可以传入用户openid,此时应用可调用本接口获取当前用户在应用中可能愿意发起互动行为的好友。
并且这些好友也很可能接受用户的互动行为,互动行为包括邀请、请求、免费礼物、挑战、炫耀等,从而提高应用的新用户安装量或老用户的留存率。

:本接口仅支持空间平台。

2 接口调用说明

2.1 URL

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

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

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明

(2)私有参数

参数名称 是否必须 类型 描述
installed 必须 string 标识需要获取的推荐好友是否已安装应用。

0:获取的均为未安装应用的好友;
1:获取的均为已安装应用的好友;
2:获取所有推荐好友,不区分是否安装应用。

2.6 请求示例

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

2.7 返回参数说明

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

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

items 获取的推荐好友信息。最多可获取50个推荐好友信息。
openid 好友对应的唯一ID。

2.8 正确返回示例

JSON示例:

Content-type: text/html; charset=utf-8

{
"ret": 0,
"is_lost": 0,
"items": [
    {
     "openid": 9CE729C9927532BABBB57F6AB000925B,
     },
    {
     "openid": 08B8273CACFBE0D9F57CAB4E7D8BDBF0,
     },
    {
     "openid": 729C9927532BABBB57F6AB000925BBF0,
     },	  
 ]
}

2.9 错误返回示例

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

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

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部