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