Account/rate limit status
(→account/rate_limit_status) |
(→account/rate_limit_status) |
||
第4行: | 第4行: | ||
{{api_url|account/rate_limit_status}} | {{api_url|account/rate_limit_status}} | ||
− | + | {{api_format|xml,json}} | |
− | xml, json | + | |
− | + | {{api_req|GET|True|False}} | |
− | GET | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
===返回:=== | ===返回:=== | ||
− | XML | + | ====XML==== |
+ | <pre> | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
<hash> | <hash> | ||
第25行: | 第18行: | ||
<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> | ||
===使用示例: === | ===使用示例: === |
2010年9月10日 (五) 14:18的版本
目录 |
account/rate_limit_status
关于API的访问频率限制。返回当前小时还能访问的次数。频率限制是根据用户请求来做的限制,具体可以参加频率限制说明。
URL
http://api.t.sina.com.cn/account/rate_limit_status.format
格式
xml,json
HTTP请求方式
GET
是否需要登录
True
请求数限制
False
关于请求数限制,参见接口访问权限说明
返回:
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 }
使用示例:
curl -u user:password http://api.t.sina.com.cn/account/rate_limit_status.xml
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']); }