サイトのトップへ戻る

Twitter 開発者 ドキュメント日本語訳




GET application/rate_limit_status

指定したリソース群に属しているメソッドの現在のレート制限を取得します。

バージョン1.1 の各API リソースは、そのメソッドのドキュメントに示されている“リソース群(resource family)”に属しています。 通常は、GETもしくはPUTの後ろにある最初のコンポーネントパスから、メソッドの属するリソース群を判別することができます。

このメソッドでは、resourcesパラメータで指定したリソース群に属するメソッドの一覧、現在の速度制限時間枠内における各リソースの残り使用回数、現在の速度制限時間枠がリセットされる時間をUNIXエポック秒で表した値、を返します。 また、現在のアクセストークンやアプリケーション単独認証コンテクストを表すrate_limit_context フィールドも返します。

また、このメソッドにパラメータを設定せずにリクエストを発行し、全てのGET メソッドのレート制限マップを取得することができます。 あなたのアプリケーションが少数のメソッドのみを使用している場合、resourcesパラメータにあなたが使用しているリソース群を設定してください。

When using app-only auth, this method’s response indicates the app-only auth rate limiting context.

詳細については API レート制限 と API レート制限早見表を読んでください。



リソースURL

https://api.twitter.com/1.1/application/rate_limit_status.json



リソース情報

応答形式
JSON
認証は必要ですか?
はい
レート制限はありますか?
はい
リクエスト回数 / 15分枠(ユーザー認証の場合)
180
リクエスト回数 / 15分枠 (アプリケーション認証の場合)
180


パラメータ

resources 任意

レート制限の状態を知りたいリソース群を、コンマ区切りで一覧にまとめたもの。ベストパフォーマンスを得るために、あなたのアプリケーションで使っているリソース群のみを設定してください。

詳細情報については API レート制限 を参照してください。

サンプル値: statuses,friends,trends,help



OAuth 署名ジェネレータ

ログインして登録アプリケーションの一覧を参照してください。



リクエスト例

GET

https://api.twitter.com/1.1/application/rate_limit_status.json?resources=help,users,search,statuses

応答結果の例

{
  "rate_limit_context": {
    "access_token": "786491-24zE39NUezJ8UTmOGOtLhgyLgCkPyY4dAcx6NA6sDKw"
  },
  "resources": {
    "users": {
      "/users/profile_banner": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      },
      "/users/suggestions/:slug/members": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/users/show/:id": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      },
      "/users/suggestions": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/users/lookup": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      },
      "/users/search": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      },
      "/users/contributors": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/users/contributees": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/users/suggestions/:slug": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      }
    },
    "statuses": {
      "/statuses/mentions_timeline": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/statuses/lookup": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      },
      "/statuses/show/:id": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      },
      "/statuses/oembed": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      },
      "/statuses/retweeters/ids": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/statuses/home_timeline": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/statuses/user_timeline": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      },
      "/statuses/retweets/:id": {
        "limit": 60,
        "remaining": 60,
        "reset": 1403602426
      },
      "/statuses/retweets_of_me": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      }
    },
    "help": {
      "/help/privacy": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/help/tos": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/help/configuration": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      },
      "/help/languages": {
        "limit": 15,
        "remaining": 15,
        "reset": 1403602426
      }
    },
    "search": {
      "/search/tweets": {
        "limit": 180,
        "remaining": 180,
        "reset": 1403602426
      }
    }
  }
}