PHPでウェブの世界と繋がろう!
menu
ホーム > PHP と Twitter > Twitter API > Accounts(アカウント) > APIのレート制限(Rate Limiting:実行可能な回数)を取得 account rate limit status

APIのレート制限(Rate Limiting:実行可能な回数)を取得 account rate limit status

Pocket

Twitter API account/rate_limit_status

API Resource
GET account/rate_limit_status
概要
 APIの現在のレート制限(Rate Limiting:API実行可能な回数)を返します。

実行可能な回数は「時間」と「許可されているリクエスト数」と「呼び出し元ユーザーである認証ユーザー(自分)かIPアドレス」により判別します。
OAuth接続している認証ユーザーの場合は、1時間あたり350リクエストを許可されています。oauth_tokenに対して測定されます。
IPアドレスでの制限の場合(認証ユーザーでない場合)は、1時間あたり150リクエストを許可されています。公共向けのIPアドレスに対して測定されます。

OAuth認証せずにこのメソッドを呼び出した場合はIPアドレスによるレート制限が返されます。
認証ユーザーのレート制限を受けるにはOAuth認証する必要があります。

また、本APIを認証しないで実行した場合は、IPアドレスでのレート制限が返ります。

このメソッドはエンドユーザーがアップロードできるメディアの数も返します。

原文
Resource URL(リソースURL)
http://api.twitter.com/1/account/rate_limit_status.format
Resource Information(リソース情報)
Rate Limited(制限) No(なし)
Requires Authentication(認証) Yes(あり)/No(なし)
Response Formats(フォーマット) json xml
HTTP Methods(HTTPメソッド) GET
サンプルコード
POINT
以下のサンプルコードを実行するにはOAuth接続が必要です。こちらのページからOAuth接続の設定を行って下さい。

– サンプル Click Here ! –

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">
<head>
<meta name="robots" content="index">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Twitter API account rate limit status APIのレート制限(Rate Limiting:実行可能な回数)を取得 表示</title>
</head>
<body>



<?php
#########################################
### 初期設定
//twitteroauth.phpをインクルードします。ファイルへのパスは環境に合わせて記述下さい。
require_once("./twitteroauth.php");

//Consumer keyの値をTwitterAPI開発者ページでご確認下さい。
$consumerKey = "***************";
//Consumer secretの値を格納
$consumerSecret = "***********************************";
//Access Tokenの値を格納
$accessToken = "***********************************";
//Access Token Secretの値を格納
$accessTokenSecret = "***********************************";

//OAuthオブジェクトを生成する
$twObj = new TwitterOAuth($consumerKey,$consumerSecret,$accessToken,$accessTokenSecret);
?>



<?php
#########################################
### ページ説明
?>

<h1>Twitter API account rate limit status APIのレート制限(Rate Limiting:実行可能な回数)を取得 表示</h1>
<!-- 説明ページurl -->
<h3><a href="http://www.tryphp.net/2012/01/31/phpapptwitter-account_rate_limit_status/">→説明はこちら</a></h3>
<hr/>



<?php
#########################################
### 取得したデータを展開
?>

<h2>取得したデータを展開</h2>
<div style="background-color:#f8f8f8;margin:20px; padding:20px; border:solid #cccccc 1px;">

<!-- // =========================== ここから =========================== -->

<?php
//API実行データ取得
$vRequest = $twObj->OAuthRequest("http://api.twitter.com/1/account/rate_limit_status.xml","GET",array());

//XMLデータをsimplexml_load_string関数を使用してオブジェクトに変換する
$oXml = simplexml_load_string($vRequest);

//オブジェクトを展開
if(isset($oXml->error) && $oXml->error != ''){
    echo "取得に失敗しました。<br/>\n";
    echo "エラーメッセージ:".$oXml->error."<br/>\n";
}else{
    echo "API<br/>\n";
    echo "remaining-hits:(".$oXml->{'remaining-hits'}.")<br/>\n";
    echo "hourly-limit:(".$oXml->{'hourly-limit'}.")<br/>\n";
    echo "reset-time:(".$oXml->{'reset-time'}.")<br/>\n";
    echo "reset-time-in-seconds:(".$oXml->{'reset-time-in-seconds'}.")<br/>\n";

    echo "写真<br/>\n";
    echo "daily-limit:(".$oXml->photos->{'daily-limit'}.")<br/>\n";
    echo "reset-time:(".$oXml->photos->{'reset-time'}.")<br/>\n";
    echo "reset-time-in-seconds:(".$oXml->photos->{'reset-time-in-seconds'}.")<br/>\n";

    echo "<hr/>\n";
}
?>

<!-- =========================== ここまで =========================== // -->
</div>
<hr/>



<?php
#########################################
### 取得したオブジェクトの内容
?>

<h2>取得したオブジェクトの内容</h2>
[PHP ruler="true" toolbar="true"]
<?php
var_dump($oXml);
?>
<\/pre>
<hr/>



</body>
</html>

– サンプル Click Here ! –


タグ(=記事関連ワード)

日付

投稿日:2012年1月31日
最終更新日:2012年07月17日

関連記事

このカテゴリの他のページ

この記事へのコメント

トラックバックurl

http://www.tryphp.net/phpapptwitter-account_rate_limit_status/trackback/