从 v1 到 v2

管理关注：标准 v1.1 与 X API v2 对比

如果你一直在使用标准 v1.1 的 POST friendships/create 和 POST friendships/destroy 端点，本指南旨在帮助你了解标准版与 X API v2 中用于管理关注的端点之间的相似与差异。

• 相似点
  • OAuth 1.0a 用户上下文
• 差异

  • 端点 URL

  • 应用与项目要求

  • HTTP 方法

  • 请求参数

     

相似之处

OAuth 1.0a 用户上下文 认证方法

这两个端点版本都支持 OAuth 1.0a 用户上下文。因此，如果您之前使用的是标准 v1.1 的关注管理端点之一，在迁移到 X API v2 版本时，仍可继续使用相同的认证方法。 

差异

Endpoint URLs

• 标准 v1.1 endpoints：
  • POST https://api.x.com/1.1/friendships/create.json （关注用户）
  • POST https://api.x.com/1.1/friendships/destroy.json （取消关注用户）
• X API v2 endpoint：
  • POST https://api.x.com/2/users/:id/following （关注用户）
  • DELETE https://api.x.com/2/users/:source_user_id/following/:target_user_id （取消关注用户）

应用和项目要求

X API v2 endpoint 在对请求进行身份验证时，要求你使用与某个项目关联的开发者应用的凭据。所有 X API v1.1 endpoint 均可使用独立版应用或与项目关联的应用的凭据。

请求参数

以下标准 v1.1 请求参数在 X API v2 中有对应项：

标准 v1.1	X API v2
无对应项	id（POST）、source_user_id（DELETE）
user_id	target_user_id
screen_name	无对应项

请注意，标准 v1.1 参数通过查询参数传递，而 X API v2 参数则通过请求体参数（适用于 POST endpoint）或路径参数（适用于 DELETE endpoint）传递。

此外，在使用标准 v1.1 endpoint 时，v2 的 id 和 source_user_id 并非必填，因为在 OAuth 1.0a 用户上下文中随请求传递的访问令牌可用于推断发起关注/取消关注操作的用户。