获取用户安装组件的状态

接口说明

获取用户安装组件的状态(如果是连接网站,则获取用户授权此应用的状态)

访问权限

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

请求URL地址

OAuth1.0a access token方式:http://api.kaixin001.com/app/status.(json|xml)
OAuth2.0 access token方式:https://api.kaixin001.com/app/status.(json|xml)
session key方式:https://api.kaixin001.com/app/status.(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/status.json?oauth_consumer_key=518888999058becc3e7c6676e2c914d7&oauth_nonce=4a292e3a29a9e50d1db6d22da473b82f&oauth_signature=jtVHsykb390pdJA1AE9PCPju168%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1309861752&oauth_token=46765_100003084_46765_1309338099_707bd340be5cd864f96c48f4b3d3700a&oauth_version=1.0&uids=53403%2C13749

请求参数说明

api参数

uids:用户ID,可以设置多个,以逗号分隔。如:123456,220993, 最多不能超过50个。

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>53403</uid>
<install>0</install>
</status>
<status>
<uid>13749</uid>
<install>1</install>
</status>
</statuses>
</statuslist>

JSON示例:

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

返回结果字段说明

字段说明
uid用户ID
install 组件安装状态
0: 未安装
1: 已安装

错误代码释义