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
关于请求数限制，参见接口访问权限说明

请求参数

注意事项

无

返回结果

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']);
}