v1 から v2 への移行

フォローの管理: Standard v1.1 と X API v2 の比較

Standard v1.1 の POST friendships/create および POST friendships/destroy エンドポイントを利用している場合、このガイドは、Standard と X API v2 のフォロー管理エンドポイントの共通点と相違点を理解するのに役立つことを目的としています。

• 共通点
  • OAuth 1.0a の User Context
• 相違点
  • エンドポイント URL
  • App と Project の要件
  • HTTP メソッド
  • リクエストパラメータ

類似点

OAuth 1.0a User Context 認証方式

両方のエンドポイントのバージョンは OAuth 1.0a User Context をサポートしています。したがって、以前に標準の v1.1 のフォロー管理エンドポイントのいずれかを使用していた場合、X API v2 版へ移行しても、同じ認証方式を引き続き使用できます。

相違点

エンドポイント URL

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

App と Project の要件

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

リクエストパラメータ

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

Standard v1.1	X API v2
対応なし	id (POST), source_user_id (DELETE)
user_id	target_user_id
screen_name	対応なし

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

また、Standard v1.1 エンドポイントを使用する場合、OAuth 1.0a User Context で渡される Access Tokens によってフォロー/フォロー解除を開始したユーザーが推論されるため、v2 の id および source_user_id は必須ではありません。

---

コードサンプル

ユーザーをフォローする (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/users/123456789/following" \
  -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/following/2244994945" \
  -H "Authorization: OAuth ..."