获取当前用户安装组件的好友uid列表

接口说明

获取当前用户安装组件的好友的uid列表(如果是连接网站,则获取当前用户授权此应用的好友uid列表)

访问权限

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

请求URL地址

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

支持格式

XML/JSON

是否使用HTTPS连接

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

HTTP请求方式

GET

是否需要登录

TRUE

注意事项

为了保护用户隐私,只有用户设置了公开或对好友设置了公开的数据才会返回。

如果请求数据不合法,或者超过请求频率限制,返回HTTP状态码400。

如果没有进行身份验证,返回HTTP状态码401。

如果没有权限访问对应的资源,返回HTTP状态码403。

如果请求的资源不存在,返回HTTP状态码404。

如果服务器内部错误,返回HTTP状态码500。

如果接口API关闭或正在升级,返回HTTP状态码502。

调用示例

http://api.kaixin001.com/app/friends.json?num=20&oauth_consumer_key=518888999058becc3e7c6676e2c914d7&oauth_nonce=9641aa33b4070c35b1aee0440eaeeca8&oauth_signature=TZ0eRW953AkclkZJu6EgqdL3k%2B4%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1309861708&oauth_token=46765_100003084_46765_1309338099_707bd340be5cd864f96c48f4b3d3700a&oauth_version=1.0&start=0

请求参数说明

api参数

start:起始搜索 (选填,默认0)。

num:需要返回记录的个数(选填,默认1024,最多1024)。

OAuth1.0验证参数

oauth_token:授权的access token。

oauth_consumer_key:应用的App Key。

oauth_signature_method:签名方法,暂只支持HMAC-SHA1。

oauth_signature:签名值,密钥为oauth_comsumer_secret和oauth_token_secret以&作为分隔符拼起来。

oauth_timestamp:时间戳, 其值是距1970 00:00:00 GMT的秒数。

oauth_nonce:单次值,随机生成的32位字符串,防止重放攻击(每次请求必须不同)。

oauth_version:(可选) 版本号,如果有必须为 1.0。

OAuth2.0验证参数

access_token:授权的access token。

调式工具地址

返回结果示例

XML示例:

<?xml version="1.0" encoding="UTF-8"?> 
<uidlist>
	<uids>
<item>13749</item>
</uids>
<prev>-1</prev>
<next>-1</next>
</uidlist>

JSON示例:

{
"uids":["13749"],
"prev":"-1",
"next":"-1"
}

返回结果字段说明

字段说明类型
uids 用户ID数组array
prev 前一分页的起始序号 string
next 后一分页的起始序号 string

错误代码释义