メインコンテンツへスキップ

manage Posts エンドポイントを使い始める**

このクイックスタートガイドでは、Postman を使用して manage Posts エンドポイントへ最初のリクエストを送信する手順を説明します。 各種言語のサンプルコードは、X API v2 sample code の GitHub リポジトリをご参照ください。
前提条件このガイドを完了するには、リクエストを認証するための keys and tokens が必要です。以下の手順でこれらのキーとトークンを生成できます。
  • 開発者アカウントに登録し、承認を受ける。
  • 開発者ポータルで Project を作成し、関連付けられた 開発者アプリ を作成する。
  • アプリの「Keys and tokens」ページに移動して必要な認証情報を生成する。すべての認証情報は安全な場所に保存すること。

manage Posts リクエストを構築する手順

ステップ1:ツールまたはライブラリから始める このエンドポイントへのリクエストには、さまざまなツール、コード例、ライブラリを利用できますが、ここでは作業を簡単にするため Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください。 Postman に X API v2 コレクションを読み込んだら、「Manage Posts」フォルダーに移動し、「Create a Post」を選択します。   ステップ2:リクエストを認証する X API に正しくリクエストするには、権限があることを確認する必要があります。manage Posts エンドポイントでこれを行うには、OAuth 1.0a ユーザーコンテキスト または OAuth 2.0 認可コード(PKCE 対応) を使用してリクエストを認証します。 この例では OAuth 1.0a ユーザーコンテキストを使用します。 キーとトークン(具体的には API Key、API Secret Key、OAuth 1.0a user Access Token、OAuth 1.0a user Access Token Secret)を Postman に追加します。Postman 右上の「X API v2」という名前の環境を選択し、環境ドロップダウン横の目のアイコンをクリックして、“initial value” と “current value” の各フィールドにキーとトークンを入力してください。 正しく設定できていれば、これらの変数はリクエストの Authorization タブに自動的に反映されます。 ステップ3:Post のテキストを指定する このエンドポイントで新しい Post を作成する場合、Post のテキストまたはメディアが必須のボディパラメータです。 Postman で「Body」タブに移動し、text パラメータの値として Post のテキストを入力します。さらに、投票、Post ID への返信、返信設定の追加などのパラメータもここで指定できます。利用可能な項目の詳細は API リファレンスガイドをご参照ください。
KeyValueParameter type
textHello world!body
ステップ4:取得したい fields を特定して指定する 準備が整ったら「Send」ボタンをクリックすると、次の例に類似したレスポンスが返ってきます。
{
  "data": {
    "id": "1445880548472328192",
    "text": "こんにちは世界!"
  }
}
返されたレスポンスオブジェクトに id と自分のPostの text が含まれていれば、Postの作成は成功です。   ステップ5:Postを削除する Postを削除するには、Postmanに読み込んだX API v2コレクションの「Manage Posts」フォルダー内にある「Delete a Post」リクエストを選択します。このエンドポイントには、削除するPostのIDが必要です。次に、「Params」タブで、削除するPostのIDを id 列の値として入力します。  削除が成功すると、次の例のようなレスポンスが返されます:
{
   "data": {
       "deleted" : true
   }
}
次のステップ APIリファレンス [サポート]https://developer.x.com/en/support/x-api) サンプルコード