跳转到主要内容

​
v2 Account Activity API 迁移指南

本指南将帮助你从旧版企业版 Account Activity API 迁移到 v2 Account Activity API。核心功能保持不变，但为与 X API v2 保持一致，端点结构和认证方式已更新。

​
变更摘要

  • API 格式：端点使用 /2/account_activity/ 基础路径，替代 /1.1/account_activity/。
  • Webhook 管理：Webhook 的创建、列出、验证（CRC）和删除由 V2 Webhooks API 处理。
  • 认证：V2 端点需要以下其一：
    • OAuthUser（三方 OAuth）用于用户级操作（例如为某用户订阅）。
    • OAuth2 App Only（Bearer Token）用于应用级操作（例如列出/删除订阅）。
    • V1.1 的要求不一，通常为 OAuth 1.0a。
  • 端点映射：
V1.1 端点V2 等价项 / 操作说明
POST /1.1/account_activity/webhooks.json?url=<URL>POST /2/webhooks文档。需要 OAuth2AppOnly。
GET /1.1/account_activity/webhooks.jsonGET /2/webhooks文档。需要 OAuth2AppOnly。
PUT /1.1/account_activity/webhooks/:webhook_id.jsonPUT /2/webhooks/:webhook_id触发 CRC。文档。需要 OAuth2AppOnly。
DELETE /1.1/account_activity/webhooks/:webhook_id.jsonDELETE /2/webhooks/:webhook_id文档。需要 OAuth2AppOnly。
POST /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonPOST /2/account_activity/webhooks/:webhook_id/subscriptions/all需要 OAuthUser。
GET /1.1/account_activity/subscriptions/count.jsonGET /2/account_activity/subscriptions/count需要 OAuth2AppOnly。
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/all需要 OAuthUser。
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/all/list需要 OAuth2AppOnly。
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allDELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all需要 OAuth2AppOnly。
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/all已弃用 / 无直接等价项请逐个删除，或通过 DELETE /2/webhooks/:webhook_id 移除该 webhook。
  • 响应格式：请在 AAAPI 文档中查看成功与错误响应结构。
迁移时，请将代码更新为使用新的基础路径，调整认证流程，并使用 V2 Webhooks API 管理 webhooks。

​
如何迁移

  • 选择套餐：
    • 为 Account Activity API 访问选择 Enterprise 或 Pro 套餐，需考虑：
      • 需要的 webhook 数量。
      • 当前/预计的订阅数或已授权用户数。
      • X 客户端应用数量。
      • 期望的支持级别（社区论坛 vs. 企业级一对一托管支持）。
      • 价格细节（Enterprise 请联系销售）。
  • 将认证更新为 OAuth 2.0：
    • 确保你的 X 应用具有“读取、写入和访问私信”的权限。
    • 将 V2 端点更新为 OAuth 2.0。如作用域有变更，请重新授权用户。
    • 使用开发者门户管理：
      • OAuth 2.0 访问令牌。
      • Client ID 和 Client Secret。
  • 验证或重新配置你的 Webhook：
    • 使用现有的 webhook URL，或设置一个新的（例如：https://your_domain.com/webhook/twitter）。
    • 按照 V2 Webhooks API 文档 注册并管理你的 webhook。
  • 示例应用：