ガイド
連携ガイド
このページでは、Bookmarks 管理エンドポイントをシステムに統合する際に押さえておくべきツールと重要な概念について説明します。内容は次のセクションに分かれています。
このエンドポイントを統合するうえで役立つ主要な概念に入る前に、次の内容に慣れておくことをおすすめします。
Postman は、エンドポイントのテストに使える優れたツールです。各 Postman リクエストには、利用可能な内容をすばやく把握できるよう、すべてのパスおよびボディパラメータが含まれています。Postman コレクションの詳細については、“Using Postman” のページをご覧ください。
お好みのプログラミング言語でこのエンドポイントを設定するためのコードをお探しですか？GitHub ページに、出発点として使えるさまざまなコードサンプルを用意しています。
コミュニティ提供のサードパーティ製ライブラリ[/x-api/tools-and-libraries/overview]を活用して、スムーズに開始しましょう。サードパーティ製ライブラリを活用して、スムーズに開始しましょう。適切なバージョンタグを確認すれば、v2 エンドポイントに対応するライブラリを見つけられます。
すべての X API v2 エンドポイントでは、キーやトークンとも呼ばれる一連の認証情報でリクエストを認証する必要があります。
これらのエンドポイントでは、OAuth 2.0 Authorization Code Flow with PKCE の使用が必須です。つまり、リクエストを成功させるには、キー一式とユーザーの Access Token を使用する必要があります。Access Token は、あなたが代理でリクエストする対象のユーザーに関連付けられている必要があります。別のユーザー向けに Access Token 一式を生成する場合は、そのユーザーが Authorize URL を用いてあなたのアプリを承認または認証する必要があります。
なお、OAuth 2.0 の取り扱いは難しい場合があります。この認証方式に不慣れな場合は、ライブラリ や Postman のようなツールを使用して、リクエストを正しく認証することを推奨します。
X API v2 のエンドポイントで使用できる認証情報一式を取得するには、開発者アカウントまたは開発者アカウントを作成し、そのアカウント内にプロジェクトまたはプロジェクトを用意し、さらにそのプロジェクト内に開発者アプリまたは開発者アプリを作成する必要があります。キーとトークンは開発者アプリ内で確認できます。
毎日、何千人もの開発者が X API にリクエストを送信しています。これらのリクエストの膨大な量を管理するため、各エンドポイントにはレート制限が設けられており、アプリまたは認証済みユーザーに代わって実行できるリクエスト数が制限されています。
これらのエンドポイントはユーザーレベルでレート制限されます。つまり、あなたがリクエストを行う対象の認証済みユーザーは、どの開発者アプリからであっても、そのエンドポイントを一定回数までしか呼び出せません。GET メソッドのユーザー単位のレート制限は 15 分あたり 180 リクエストです。Bookmarks ルックアップエンドポイントの GET メソッドでは、直近のブックマーク済み Post を最大 800 件取得できます。さらに、POST および DELETE メソッドのユーザー単位のレート制限は 15 分あたり 50 リクエストです。