v1 から v2 への移行

リストの管理: standard v1.1 と X API v2 の比較

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

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

類似点

認証

エンドポイントの両バージョンとも OAuth 1.0a User Context をサポートしています。そのため、これまで標準 v1.1 のリスト管理用エンドポイントのいずれかを使用していた場合、X API v2 のエンドポイントに移行しても、同じ認証方法を引き続き使用できます。

相違点

エンドポイント URL

• 標準 v1.1 エンドポイント:
  • POST https://api.x.com/1.1/lists/create.json (リストを作成)
  • POST https://api.x.com/1.1/lists/destroy.json (リストを削除)
  • POST https://api.x.com/1.1/lists/update.json (リストを更新)
• X API v2 エンドポイント:

  • POST https://api.x.com/2/lists (リストを作成)

  • DELETE https://api.x.com/2/lists/:id (リストを削除)

  • PUT https://api.x.com/2/lists/:id (リストを更新)

レート制限

Standard v1.1	X API v2
/1.1/lists/create.json なし	/2/lists OAuth 1.0a ユーザーコンテキストで 15 分間に 300 リクエスト
/1.1/lists/destroy.json なし	/2/lists/:id OAuth 1.0a ユーザーコンテキストで 15 分間に 300 リクエスト
/1.1/lists/update.json なし	/2/lists/:id OAuth 1.0a ユーザーコンテキストで 15 分間に 300 リクエスト

App と Project の要件

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

リクエストパラメータ

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

リストを作成

Standard	X API v2
name	name
mode	private
description	description

リストを削除/更新

Standard	X API v2
owner_screen_name	対応するパラメータなし
owner_id	対応するパラメータなし
list_id	id
slug	対応するパラメータなし

注意: 標準 v1.1 のパラメータはクエリパラメータとして渡されますが、X API v2 のパラメータは、POST エンドポイントではボディパラメータとして、DELETE および PUT エンドポイントではパスパラメータとして渡されます。

---

コード例

リストを作成する (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"name": "My List", "description": "A great list"}'

リストを削除する (v2)

cURL

shellscript

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