添加好友

接口说明

添加好友

访问权限

默认权限(basic)即可调用。欲了解更多有关访问权限的知识,请参考接口访问权限说明

请求URL地址

OAuth1.0a access token方式:http://api.kaixin001.com/friends/add.(json|xml)
OAuth2.0 access token方式:https://api.kaixin001.com/friends/add.(json|xml)
session key方式:https://api.kaixin001.com/friends/add.(json|xml)

支持格式

XML/JSON

是否使用HTTPS连接

OAuth1.0a access token方式:否
OAuth2.0 access token方式:是
session key方式:是

HTTP请求方式

POST

是否需要登录

True

注意事项

若参数touid、code、rcode、content缺失, 返回错误提示: app_addfriend_param_wrong
若参数touid类型错误,返回提示:app_param_wrong
若参数token缺失或者错误,返回错误提示:oauth_invalid_access

调用示例

请求参数说明

字段说明
touid要添加为好友的用户ID
code用户输入的验证码
rcode验证码识别串
content好友请求说明

获取验证码图片

获取地址:
http://www.kaixin001.com/interface/createwavecaptcha.php?norect=1&randnum={rcode}
其中{rcode}为唯一随机数
建议使用: now =new Date();
Math.random()+ “_”+ now.getTime();

示例:

<div id="codeimg"></div> <a href="javascript:chgCode('codeimg', 'rcode')">换一个</a></p>
<script type="text/javascript">
chgCode("codeimg", "rcode");
function chgCode(id, rcode) {
	var now =new Date();
	var rnd = Math.random();
	var rcode = rnd +"_"+now.getTime();
	document.getElementById(rcode).value = rcode;
	document.getElementById(id).innerHTML = "<img src='http://www.kaixin001.com/interface/createwavecaptcha.php?norect=1&randnum="+rcode+"'>";
}
</script>

返回结果示例

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<result>1</result>

JSON示例

{
    "result": "1"
}

返回结果字段说明

字段说明类型
result 加好友返回的状态
成功为1
失败返回相应信息
string

错误代码释义