リストメンバーの管理

リストメンバーの管理: Standard v1.1 と X API v2 の比較

Standard v1.1 の POST lists/members/create および POST lists/members/destroy エンドポイントを使用している場合、このガイドでは、Standard v1.1 と X API v2 のリストメンバー管理エンドポイント間の共通点と相違点を理解できるように説明します。

• 共通点
  • 認証
• 相違点
  • エンドポイント URL
  • App および Project の要件
  • HTTP メソッド
  • レート制限
  • リクエストパラメータ

類似点

認証

どちらのエンドポイントのバージョンも OAuth 1.0a User Context をサポートしています。したがって、以前に standard v1.1 の List メンバー管理用エンドポイントのいずれかを使用していた場合、X API v2 のバージョンに移行しても、同じ認証方法を引き続き使用できます。

違い

エンドポイント URL

• Standard v1.1 エンドポイント:
  • POST https://api.x.com/1.1/lists/members/create.json (指定したリストにメンバーを追加します)
  • POST https://api.x.com/1.1/lists/members/destroy.json (指定したリストからメンバーを削除します)
• X API v2 エンドポイント:

  • POST https://api.x.com/2/lists/:id/members (指定したリストにメンバーを追加します)

  • DELETE https://api.x.com/2/lists/:id/members/:user_id (指定したリストからメンバーを削除します)

レート制限

Standard v1.1	X API v2
/1.1/lists/members/create.json なし	/2/lists/:id/members OAuth 1.0a User Context では 15 分間に 300 リクエスト OAuth 2.0 Authorization Code with PKCE では 15 分間に 300 リクエスト
/1.1/lists/members/destroy.json なし	/2/lists/:id/members/:user_id OAuth 1.0a User Context では 15 分間に 300 リクエスト OAuth 2.0 Authorization Code with PKCE では 15 分間に 300 リクエスト

App と Project の要件

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

リクエストパラメータ

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

Standard v1.1	X API v2
list_id	id
slug	対応なし
screen_name	対応なし
owner_screen_name	対応なし
owner_id	対応なし