Account/rate limit status
(→PHP示例) |
|||
(未显示2个用户的5个中间版本) | |||
第1行: | 第1行: | ||
− | + | {{api_desc2| | |
− | + | uri=account/rate_limit_status| | |
− | + | desc=获取API的访问频率限制。返回当前小时内还能访问的次数。频率限制是根据用户请求来做的限制,具体细节参见:[[Rate-limiting|接口访问权限说明]]。| | |
− | = | + | format=XML/JSON| |
− | + | httpMethod=GET| | |
− | + | needAuth=true| | |
− | = | + | rateLimit=true| |
− | + | params=| | |
− | + | getParam=| | |
− | = | + | postParam=| |
− | GET | + | result= |
− | + | ===XML示例=== | |
− | = | + | <pre> |
− | true | + | <?xml version="1.0" encoding="UTF-8"?> |
− | + | ||
− | === | + | |
− | + | ||
− | + | ||
− | === | + | |
− | + | ||
− | + | ||
<hash> | <hash> | ||
<remaining-hits type="integer">150</remaining-hits> | <remaining-hits type="integer">150</remaining-hits> | ||
第26行: | 第19行: | ||
<reset-time type="datetime">Mon Feb 01 03:15:22 +0800 2010</reset-time> | <reset-time type="datetime">Mon Feb 01 03:15:22 +0800 2010</reset-time> | ||
</hash> | </hash> | ||
− | + | </pre> | |
− | + | ===JSON示例=== | |
− | + | <pre> | |
− | "reset_time":"Mon Feb 01 03:15:22 +0800 2010","remaining_hits":150} | + | { |
− | + | "hourly_limit":150, | |
− | = | + | "reset_time_in_seconds":1264994122, |
− | + | "reset_time":"Mon Feb 01 03:15:22 +0800 2010", | |
− | + | "remaining_hits":150 | |
− | + | } | |
+ | </pre>| | ||
+ | useAge=无| | ||
+ | otherInfo= | ||
+ | ===Java示例=== | ||
请从 [[SDK | 微博SDK开发包下载]] 下载Java SDK<br> | 请从 [[SDK | 微博SDK开发包下载]] 下载Java SDK<br> | ||
代码示例如下: | 代码示例如下: | ||
第61行: | 第58行: | ||
} | } | ||
} | } | ||
− | + | ===PHP示例=== | |
请从 [[SDK | 微博SDK开发包下载]] 处下载PHP SDK(支持OAuth验证之版本)<br> | 请从 [[SDK | 微博SDK开发包下载]] 处下载PHP SDK(支持OAuth验证之版本)<br> | ||
代码示例如下: | 代码示例如下: | ||
第85行: | 第82行: | ||
} | } | ||
</pre> | </pre> | ||
+ | }} |
2012年3月20日 (二) 14:14的最后版本
目录 |
account/rate_limit_status
获取API的访问频率限制。返回当前小时内还能访问的次数。频率限制是根据用户请求来做的限制,具体细节参见:接口访问权限说明。
URL
http://api.t.sina.com.cn/account/rate_limit_status.(json%7Cxml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
true
关于授权机制,参见授权机制声明
请求数限制
true
关于请求数限制,参见接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
注意事项
无
返回结果
XML示例
<?xml version="1.0" encoding="UTF-8"?> <hash> <remaining-hits type="integer">150</remaining-hits> <hourly-limit type="integer">150</hourly-limit> <reset-time-in-seconds type="integer">1264994233</reset-time-in-seconds> <reset-time type="datetime">Mon Feb 01 03:15:22 +0800 2010</reset-time> </hash>
JSON示例
{ "hourly_limit":150, "reset_time_in_seconds":1264994122, "reset_time":"Mon Feb 01 03:15:22 +0800 2010", "remaining_hits":150 }
其他
Java示例
请从 微博SDK开发包下载 下载Java SDK
代码示例如下:
package weibo4j.examples.account; import weibo4j.RateLimitStatus; import weibo4j.Weibo; import weibo4j.WeiboException; public class GetRateLimitStatus { /** * 获取当前用户API访问频率限制 * @param args */ public static void main(String[] args) { System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY); System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET); try { Weibo weibo = new Weibo(); weibo.setToken(args[0], args[1]); RateLimitStatus limitStatus = weibo.rateLimitStatus(); System.out.println(limitStatus.toString()); } catch (WeiboException e) { e.printStackTrace(); } } }
PHP示例
请从 微博SDK开发包下载 处下载PHP SDK(支持OAuth验证之版本)
代码示例如下:
//account/rate_limit_status //获取当前用户API访问频率限制 $c = new WeiboClient( WB_AKEY , WB_SKEY , $_SESSION['last_key']['oauth_token'] , $_SESSION['last_key']['oauth_token_secret'] ); $msg = $c->oauth->get("http://api.t.sina.com.cn/account/rate_limit_status.json"); if ($msg === false || $msg === null){ echo "Error occured"; return false; } if (isset($msg['error_code']) && isset($msg['error'])){ echo ('Error_code: '.$msg['error_code'].'; Error: '.$msg['error'] ); return false; } if (isset($msg['hourly_limit'])){ echo($msg['hourly_limit']); }
文档更新时间: 2012-03-20