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