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