Skip to main content

いいねの管理: Standard v1.1 と X API v2 の比較

standard v1.1 の POST favorites/createPOST favorites/destroy エンドポイントを利用している場合、このガイドの目的は、standard v1.1 と X API v2 におけるいいね管理エンドポイントの共通点と相違点を理解するうえで役立つ情報を提供することです。
  • 共通点
    • OAuth 1.0a ユーザーコンテキスト
  • 相違点
    • エンドポイント URL と HTTP メソッド
    • App と Project の要件
    • リクエストパラメータ

類似点

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

相違点

エンドポイント URL と HTTP メソッド App と Project の要件 X API v2 エンドポイントでは、リクエストの認証時に、developer App のうち Project に関連付けられているものから取得した認証情報を使用する必要があります。すべての X API v1.1 エンドポイントは、単独の App からの認証情報でも、Project に関連付けられた App からの認証情報でも使用できます。 リクエストパラメータ 次の Standard v1.1 リクエストパラメータには、X API v2 での対応があります。
Standard v1.1X API v2
idid
includes_entities対応するパラメータはありません
Standard v1.1 のパラメータはクエリパラメータとして渡される一方、X API v2 のパラメータは POST エンドポイントではボディパラメータとして、DELETE エンドポイントではパスパラメータとして渡される点に注意してください。 また、Standard v1.1 エンドポイントを使用する場合、ポストに「いいね」するユーザーの id を指定する必要はありません。これは、OAuth 1.0a User Context とともに渡される Access Tokens によって、どのユーザーが「いいね」や「いいね」の取り消しを実行しているかが推論されるためです。

コードサンプル

ポストに「いいね」を付ける (v2)

cURL
curl -X POST "https://api.x.com/2/users/123456789/likes" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'

ポストのいいねを解除する (v2)

cURL
curl -X DELETE "https://api.x.com/2/users/123456789/likes/1234567890" \
  -H "Authorization: OAuth ..."