ミュート管理

ミュートの管理：Standard v1.1 と X API v2 の比較

standard v1.1 の POST mutes/users/create と POST mutes/users/destroy エンドポイントを利用している場合、このガイドは、standard v1.1 と X API v2 におけるミュート管理エンドポイントの共通点と相違点を理解するための手助けとなることを目的としています。

• 共通点
  • OAuth 1.0a ユーザーコンテキスト
• 相違点
  • エンドポイント URL
  • App および Project の要件
  • HTTP メソッド
  • リクエストパラメータ

共通点

OAuth 1.0a User Context 認証方法

両方のエンドポイントバージョンは OAuth 1.0a User Context をサポートします。したがって、以前に Standard v1.1 の manage mutes エンドポイントのいずれかを使用していた場合、X API v2 バージョンへ移行しても、同じ認証方法をそのまま利用できます。

相違点

エンドポイント URL

• Standard v1.1 エンドポイント:
  • POST https://api.x.com/1.1/mutes/users/create.json (ユーザーをミュート)
  • POST https://api.x.com/1.1/mutes/users/destroy.json (ユーザーのミュート解除)
• X API v2 エンドポイント:
  • POST https://api.x.com/2/users/:id/muting (ユーザーをミュート)
  • DELETE https://api.x.com/2/users/:source_user_id/muting/:target_user_id (ユーザーのミュート解除)

App と Project の要件

X API v2 エンドポイントでは、リクエストを認証する際に、Project に関連付けられている developer App の認証情報を使用する必要があります。すべての X API v1.1 エンドポイントでは、Project に関連付けられていない App、または Project に関連付けられている App のいずれかの認証情報を使用できます。

リクエストパラメータ

次の Standard v1.1 リクエストパラメータには、X API v2 における対応するパラメータがあります:

Standard v1.1	X API v2
user_id	target_user_id
screen_name	対応なし

Standard v1.1 のパラメータはクエリパラメータとして渡される一方で、X API v2 のパラメータはボディパラメータ (POST エンドポイントの場合) またはパスパラメータ (DELETE エンドポイントの場合) として渡される点に注意してください。

また、Standard v1.1 エンドポイントを使用する場合、対象ユーザーをミュートするユーザーの id を指定する必要はありません。これは、OAuth 1.0a User Context で渡されるアクセス トークンによって、どのユーザーがミュート／ミュート解除を実行しているかが判断されるためです。

---

コード例

ユーザーをミュートする (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/users/123456789/muting" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'

ユーザーのミュート解除 (v2)

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/123456789/muting/2244994945" \
  -H "Authorization: OAuth ..."