2009年11月6日 (五) 09:43的版本

account/rate_limit_status

关于API的访问频率限制。待定。

Returns the remaining number of API requests available to the requesting user before the API limit is reached for the current hour. Calls to rate_limit_status do not count against the rate limit. If authentication credentials are provided, the rate limit status for the authenticating user is returned. Otherwise, the rate limit status for the requester's IP address is returned. Learn more about the REST API rate limiting.

URL:

http://api.t.sina.com.cn/account/rate_limit_status.format

Formats:

xml, json

HTTP Method(s):

GET

Requires Authentication (about authentication):

true, to determine a user's rate limit status false, to determine the requesting IP's rate limit status

API rate limited (about rate limiting):

false

Geolocation [COMING SOON]:

The <user> object contains the geo_enabled flag which, by default is false for all users. For more information, see the statuses/update method for more information.

Response (about return values):

XML example (truncated):

<?xml version="1.0" encoding="UTF-8"?>
<hash>
 <remaining-hits type="integer">19933</remaining-hits>
 <hourly-limit type="integer">20000</hourly-limit>
 <reset-time type="datetime">2009-04-08T21:57:23+00:00</reset-time>
 <reset-time-in-seconds type="integer">1239227843</reset-time-in-seconds>
</hash>

Usage examples:

cURL (about cURL):

curl -u user:password http://api.t.sina.com.cn/account/rate_limit_status.xml