Skip to main content

​
リツイートの管理: standard v1.1 と X API v2 の比較

standard v1.1 の POST statuses/retweet/:id および POST statuses/unretweet/:id エンドポイントを使用している場合、本ガイドは standard v1.1 と X API v2 のリツイート用エンドポイントの類似点と相違点を理解するのに役立つことを目的としています。
  • 類似点
    • 認証
  • 相違点
    • エンドポイント URL と HTTP メソッド
    • リクエスト制限
    • App と Project の要件
    • リクエストパラメータ

​
類似点

認証 標準 v1.1 と X API v2 の両方にある Retweets を管理するエンドポイント (POST statuses/retweet/:id および POST statuses/unretweet/:id) では、OAuth 1.0a User Context を使用します。したがって、以前に標準 v1.1 の Retweets lookup エンドポイントのいずれかを使用していた場合、X API v2 の対応エンドポイントに移行しても、同じ認証方法を引き続き使用できます。 

​
違い

エンドポイント URL と HTTP メソッド App と Project の要件 X API v2 エンドポイントでは、リクエストを認証する際に、developer App の資格情報を使用する必要があります。この App は Project に関連付けられている必要があります。すべての X API v1.1 エンドポイントは、App からの資格情報、または App に関連付けられた App からの資格情報を使用できます。 リクエストパラメータ 次の Standard v1.1 リクエストパラメータは、2 つのクエリパラメータ (user_id または screen_name) を受け付けていました。X API v2 では数値のユーザー ID のみを受け付け、エンドポイントパスの一部として渡す必要があります。
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/retweets" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "1234567890"}'

​
リツイートの取り消し (v2)

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