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

返信を非表示にするエンドポイントのはじめ方

このクイックスタートガイドでは、Postman を使用して返信を非表示にするエンドポイントへの最初のリクエストを送信する方法を説明します。 各種言語のコードスニペットを確認する場合は、返信を非表示にする API リファレンスページをご覧ください。 

前提条件

このガイドを完了するには、リクエストを認証するためのキーとトークンが必要です。以下の手順に従って、これらのキーとトークンを生成できます。
  • 開発者アカウントに登録し、承認を受けてください。
  • 開発者ポータルで、Project と、それに関連付けられた アプリ を作成します。
  • アプリの “Keys and tokens” ページに移動し、必要な認証情報を生成します。すべての認証情報は安全な場所に保存してください。

PUT /tweets/:id/hidden リクエストの作成手順

ステップ1:ツールまたはライブラリから始める

このエンドポイントへのリクエストには、さまざまなツールやコード例、ライブラリを利用できますが、ここでは手順を簡略化するために Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください。 Postman で X API v2 コレクションを読み込んだら、hide replies エンドポイントに移動してください。

ステップ2:リクエストを認証する

X API に正しくリクエストを送るには、権限があることを確認する必要があります。このエンドポイントでは、OAuth 1.0a ユーザーコンテキスト または OAuth 2.0 認可コード(PKCE 対応) を使用してリクエストを認証する必要があります。 この例では、OAuth 1.0a ユーザーコンテキストを使用します。 API Key、API Secret Key、OAuth 1.0a ユーザー Access Token、OAuth 1.0a ユーザー Access Token Secret といったキーとトークンを Postman に追加する必要があります。Postman の右上で “X API v2” という名前の environment を選択し、“initial value” と “current value” の fields(environment のドロップダウン横の目のアイコンをクリック)にキーとトークンを追加してください。 正しく設定できていれば、これらの変数はリクエストの authorization タブに自動的に取り込まれます。  

ステップ3:非表示にするPostのIDを見つける

hide repliesエンドポイントは、認可されたユーザーに代わって返信を非表示または再表示できます。この例では、あなたのユーザープロフィールに関連付けられたAccess Tokenを使用しているため、あなたが開始した会話に参加しているユーザーからの返信を非表示にできます。同様に、あなたのアプリを認可した別のユーザーに属するAccess Tokenを使用している場合は、そのアカウントが開始した会話の返信をモデレートできます。 友人にPostへ返信してもらう(hide repliesのテストであることを伝えてください)か、テストアカウントであなたの任意のPostに返信します。その返信をクリックし、URLの数値部分をコピーします。これが非表示にするPost IDです。 この例では、次のPostを参照します。IDは 1232720193182412800 です。 https://x.com/TwitterDev/status/1232720193182412800

ステップ4:Post を非表示にする

Postman で Hide replies フォルダーを開き、Hide a reply を選択します。Params タブで id フィールドの横に Post ID を貼り付けます(URL の :id を置き換える必要はありません)。「Send」をクリックすると、成功のレスポンスが表示されます。 {"hidden":true}

ステップ5:Post の非表示を解除する

非表示の Post は X アプリの別タブに移動されます。Postman で Post の非表示を解除するには、Hide replies フォルダーを開き、Unhide a reply を選択します。Params タブで、前のステップで使用したのと同じ Post ID を id フィールドに貼り付けます。「Send」をクリックすると、成功のレスポンスが表示されます。 {"hidden":false} hidden フィールドは Post の非表示状態を表します。true は Post が非表示であることを意味し、false は非表示ではないことを意味します。