ガイド
統合ガイド
このページには、投稿を管理するエンドポイントをシステムに統合する際に知っておくべきいくつかのツールと主要な概念に関する情報が含まれています。このページをいくつかのセクションに分けました：
このエンドポイントを統合するうえで役立つ重要な概念に入る前に、まず次の内容に慣れておくことをおすすめします。
Postman は、エンドポイントをテストするのに便利なツールです。各 Postman リクエストには、利用可能な内容をすばやく把握できるよう、すべてのパスおよびボディのパラメータが含まれています。Postman コレクションの詳細については、“Postman の使い方”ページをご覧ください。
お好みのプログラミング言語でこのエンドポイントを使い始めたい方へ。出発点として使える各種コードサンプルを、GitHub ページで公開しています。
コミュニティ提供のサードパーティ製ライブラリを活用して、スムーズに開始しましょう。v2 エンドポイントに対応するライブラリは、適切なバージョンタグを確認して見つけられます。
すべての X API v2 エンドポイントでは、キーやトークンとも呼ばれる一連の認証情報を用いてリクエストを認証する必要があります。
これらのエンドポイントでは OAuth 1.0a ユーザーコンテキスト の使用が必須です。つまり、リクエストを成功させるには API キーとユーザーの Access Token のセットを使用する必要があります。Access Token は、あなたが代行してリクエストを行う対象のユーザーに関連付けられていなければなりません。別のユーザーの Access Token を生成する場合は、そのユーザーが 3-legged OAuth フロー を用いてあなたのアプリを承認または認証する必要があります。
OAuth 1.0a の利用は難しい場合があります。この認証方式に不慣れな場合は、ライブラリ を利用する、Postman のようなツールを使用する、または OAuth 2.0 でリクエストを認証することを推奨します。
OAuth 2.0 Authorization Code with PKCE は、アプリケーションのスコープをより細かく制御でき、複数デバイス間にまたがる認可フローにも対応します。OAuth 2.0 では、ユーザーに代わって特定の権限を付与する細かなスコープを選択できます。
アプリで OAuth 2.0 を有効にするには、開発者ポータルのアプリ設定内にある認証設定で有効化してください。
X API v2 のエンドポイントで使用できる一連の認証情報を取得するには、開発者アカウントを作成し、そのアカウント内にプロジェクトを設定し、そのプロジェクト内に開発者アプリを作成する必要があります。キーとトークンは、開発者アプリ内で確認できます。
毎日、数千人規模の開発者が X API にリクエストを送信しています。こうした膨大なリクエスト量を管理するため、各エンドポイントにはレート制限が設定されており、アプリまたは認証済みユーザーに代わって実行できるリクエスト数が制限されています。
これらのエンドポイントはユーザーレベルでレート制限されます。つまり、あなたが代行してリクエストを行う認証済みユーザーは、どの開発者アプリからであっても、そのエンドポイントを一定回数までしか呼び出せません。POST メソッドのユーザーレート制限は 15 分あたり 200 リクエストです。DELETE メソッドは 15 分あたり 50 リクエストに制限されています。さらに、manage Posts または manage Retweets によって作成された Post を含め、3 時間あたり 300 リクエストという上限があります。
アプリ名とウェブサイトのURLは、アプリケーションによってプログラムで作成されたPostのメタデータ内でソースラベルとして表示されます。Xのアプリのユースケースを変更する場合は、Developer Termsに準拠するため、これらの設定で必ずユースケースを更新してください。
プロフィール設定でジオ機能を有効にしている場合にのみ、Post に位置情報を追加できます。ジオ機能を有効にしていない場合でも、リクエストボディに location パラメータを含めることはできますが、Post には紐付けられません。画像でユーザーをタグ付けする場合も同様です。タグ付け対象のユーザーが写真へのタグ付けを有効にしていない場合、Post 自体は正常に作成されても、タグ付けされたユーザーの一覧にそのユーザー名は表示されません。
現在、X API v2 ではメディアのフルアップロードは行えません。ただし、以前にアップロードしたメディアを Post に添付することは可能です。すでに v1 のメディアエンドポイント または X Media Studio を使用してアップロード済みの media id を利用できます。これらの media id は、あなた自身または認証済みユーザーのものに限られます。
次のステップ
API リファレンス