- 便利なツール
- 重要な概念
- 認証
- 開発者ポータル、プロジェクト、アプリ
- レート制限
便利なツール
Postman
コードサンプル
サードパーティ製ライブラリ
重要な概念
認証
開発者ポータル、Projects、開発者 Apps
レート制限
| エンドポイント | HTTP メソッド | レート制限 |
| /2/lists | POST | 15 分あたり 300 リクエスト |
| /2/lists/:id | DELETE / PUT | 15 分あたり 300 リクエスト |
ガイド
連携ガイド
このページでは、Lists エンドポイントをシステムに統合するうえで把握しておくべき主要なツールと重要概念について説明します。ページは次のセクションで構成されています。
このエンドポイントの統合に役立つ重要な概念に入る前に、次の内容に慣れておくことをおすすめします。
Postman は、エンドポイントのテストに最適なツールです。各 Postman リクエストには、利用可能な項目をすばやく把握できるよう、すべてのパスおよびボディパラメータが含まれています。Postman コレクションの詳細は、“Postman の使用” ページをご覧ください。
お好みのプログラミング言語でこのエンドポイントをセットアップしたい方へ。出発点として使えるさまざまなコードサンプルを、GitHub ページで提供しています。
コミュニティが提供するサードパーティ製ライブラリを活用して、スムーズに始めましょう。適切なバージョンタグを確認すれば、v2 エンドポイントに対応するライブラリを見つけられます。元の英語版ページも参照できます: third-party libraries
すべての X API v2 エンドポイントでは、キーやトークンとも呼ばれる一連の認証情報を使ってリクエストを認証する必要があります。
これらのエンドポイントでは OAuth 1.0a ユーザーコンテキスト の使用が必須です。つまり、リクエストを成功させるには、API キー一式とユーザーの Access Token を使用する必要があります。Access Token は、あなたが代理してリクエストを行うユーザーに関連付けられていなければなりません。別のユーザー向けの Access Token を生成する場合は、そのユーザーが 3-legged OAuth フロー を使ってあなたのアプリを承認または認証する必要があります。
OAuth 1.0a の取り扱いは難しい場合があります。この認証方式に不慣れな場合は、ライブラリ や Postman のようなツールを使って、リクエストを適切に認証することをおすすめします。
X API v2 のエンドポイントで使用できる一連の認証情報を取得するには、開発者アカウントに登録し、そのアカウント内でProjectを設定し、その Project 内で開発者 Appを作成する必要があります。キーとトークンは開発者 App 内で確認できます。
毎日、何万もの開発者が X API にリクエストを送信しています。これらの膨大なリクエスト量を管理するため、各エンドポイントにはレート制限が設けられており、アプリまたは認証済みユーザーに代わって行えるリクエスト数が制限されています。
これらのエンドポイントはユーザーレベルでレート制限されています。つまり、あなたが代行してリクエストを行う認証済みユーザーは、どの開発者アプリからであっても、そのエンドポイントを一定回数しか呼び出せません。
以下の表は各エンドポイントのレート制限を示しています。