メインコンテンツへスキップアカウントをミュートすると、そのアカウントをフォロー解除やブロックをせずに、そのアカウントのPostをタイムラインから非表示にできます。ミュートしたことは相手に知られることはなく、いつでもミュートを解除できます。manage mutes エンドポイントを使用すると、開発者はX上でより安全な体験を提供できます。manage mutes の活用例としては、特定のトピックについてPostする可能性のあるアカウントを、指定した期間ミュートできるアプリがあります。mutes lookup エンドポイントでは、あなたまたは認証済みユーザーが誰をミュートしているかを確認できます。これは、ミュートしているアカウントとの関わり方を把握するのに役立ちます。
mute lookup では非公開情報へのリクエストを行い、manage mutes ではユーザーに代わって操作を行うため、これらのエンドポイントはOAuth 1.0a ユーザーコンテキストまたはOAuth 2.0 認可コード(PKCE 対応)で認証し、あなたのアプリを認可したユーザーに紐づくユーザー Access Tokens を使用する必要があります。これらのトークンは、3-legged OAuth フロー(OAuth 1.0a)またはAuthorization Code with PKCE grant flow(OAuth 2.0)を使用して生成できます。
ミュート照会エンドポイントでは、認証済みユーザーがミュートしているアカウントを確認できます。このエンドポイントのレート制限は、ユーザーあたり15分につき15件のリクエストです。
ミュート管理エンドポイントを使用すると、認証済みユーザーに代わって指定したアカウントをミュートまたはミュート解除できます。これらのエンドポイントには POST と DELETE の 2 つのメソッドがあります。POST メソッドではアカウントをミュートし、DELETE メソッドではミュート解除します。POST および DELETE の両エンドポイントに対するユーザーごとのレート制限は、15 分あたり 50 リクエストです。
ご注意: ユーザーが X 上でミュートする場合は、15 分あたり 200 リクエストの上限があります。
アカウントのセットアップ
これらのエンドポイントにアクセスするには、以下が必要です:
X API v2 のエンドポイントへのアクセス方法については、はじめにガイドをご覧ください。