获取用户邀请成功的好友uid列表

接口说明

获取某人邀请成功的好友uid列表

访问权限

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

请求URL地址

OAuth1.0a access token方式:http://api.kaixin001.com/app/invited.(json|xml)
OAuth2.0 access token方式:https://api.kaixin001.com/app/invited.(json|xml)
session key方式:https://api.kaixin001.com/app/invited.(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/invited.json?num=20&oauth_consumer_key=518888999058becc3e7c6676e2c914d7&oauth_nonce=7b089226d01bb37a80350264218e749e&oauth_signature=NBSQzvDAzERKTU8UW21si0qw6rg%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1309861782&oauth_token=46765_100003084_53403009_1309338099_707bd340be5cd864f96c48f4b3d3700a&oauth_version=1.0&start=0&uid=53403009

请求参数说明

api参数

uid:用户ID。

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"?> 
<statuslist>
	<statuses>
<status>
	<uid>13749</uid>
	<install>1</install>
	</status>
</statuses>
<prev>0</prev>
<next>0</next>
</statuslist>

JSON示例:

{
"statuses": [
	{
	"uid":"13749",
	"install":"1"
	}
],
    "prev": "0",
    "next": "0"
}

返回结果字段说明

字段说明类型
uid 用户IDstring
Install 组件安装状态
0: 未安装
1: 已安装
string
prev 前一分页的起始序号 string
next 后一分页的起始序号 string

错误代码释义