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