查询剩余请求数

接口说明

查询当前应用的剩余请求数

访问权限

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

请求URL地址

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

支持格式

XML/JSON

是否使用HTTPS连接

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

HTTP请求方式

GET

是否需要登录

TRUE

注意事项

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

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

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

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

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

调用示例

http://api.kaixin001.com/app/rate_limit_status.json?oauth_consumer_key=5180152736965add8e7795c0bc7e1523&oauth_nonce=9768a02273f346466242777757bbc66c&oauth_signature=L5UCGYdWfSApgAsv8eocAK7Gp4M%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1311586853&oauth_token=86add2ef712d05d2d267f7c9629aca&oauth_version=1.0

请求参数说明

api参数

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"?>
<ratelimit>
<hourly_limit>1000</hourly_limit>
<remaining_hits>800</remaining_hits>
</ratelimit>

JSON示例:

{
    "hourly_limit": "1000",
    "remaining_hits":"800"
}

返回结果字段说明

字段说明类型
hourly_limit每个小时最大的访问次数string
remaining_hits当前剩余的访问次数string

错误代码释义