Saltar al contenido principal

​
Guía de migración a la Account Activity API v2

Esta guía le ayuda a migrar desde la Account Activity API de Enterprise (legada) a la Account Activity API v2. La funcionalidad principal se mantiene, pero las estructuras de los endpoint y los métodos de autenticación se han actualizado para mantener la coherencia con la X API v2.

​
Resumen de cambios

  • Formato de la API: Los endpoints usan la ruta base /2/account_activity/ en lugar de /1.1/account_activity/.
  • Gestión de webhooks: La creación, el listado, la validación (CRC) y la eliminación de webhooks se gestionan mediante la V2 Webhooks API.
  • Autenticación: Los endpoints de v2 requieren uno de los siguientes:
    • OAuthUser (OAuth con 3 patas) para acciones específicas de usuario (p. ej., suscribir a un usuario).
    • OAuth2 App Only (Bearer Token) para acciones a nivel de App (p. ej., listar/eliminar suscripciones).
    • v1.1 usaba requisitos variados, a menudo OAuth 1.0a.
  • Correspondencia de endpoints:
Endpoint de v1.1Equivalente/acción en v2Notas
POST /1.1/account_activity/webhooks.json?url=<URL>POST /2/webhooksDocs. Requiere OAuth2AppOnly.
GET /1.1/account_activity/webhooks.jsonGET /2/webhooksDocs. Requiere OAuth2AppOnly.
PUT /1.1/account_activity/webhooks/:webhook_id.jsonPUT /2/webhooks/:webhook_idActiva el CRC. Docs. Requiere OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id.jsonDELETE /2/webhooks/:webhook_idDocs. Requiere OAuth2AppOnly.
POST /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonPOST /2/account_activity/webhooks/:webhook_id/subscriptions/allRequiere OAuthUser.
GET /1.1/account_activity/subscriptions/count.jsonGET /2/account_activity/subscriptions/countRequiere OAuth2AppOnly.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/allRequiere OAuthUser.
GET /1.1/account_activity/webhooks/:webhook_id/subscriptions/all/list.jsonGET /2/account_activity/webhooks/:webhook_id/subscriptions/all/listRequiere OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allDELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allRequiere OAuth2AppOnly.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/allObsoleto / Sin equivalente directoUse eliminaciones individuales o elimine el webhook mediante DELETE /2/webhooks/:webhook_id.
  • Formatos de respuesta: Revise las estructuras de respuestas de éxito y error en la documentación de AAAPI.
Al migrar, actualice su código para usar las nuevas rutas base, ajuste los flujos de autenticación y gestione los webhooks usando la V2 Webhooks API.

​
Cómo migrar

  • Decidir un paquete:
    • Elija el paquete Enterprise o Pro para acceder a Account Activity API, teniendo en cuenta:
      • Número de webhooks necesarios.
      • Suscripciones o usuarios autorizados actuales y previstos.
      • Número de aplicaciones cliente de X.
      • Nivel de soporte deseado (foro vs. soporte empresarial gestionado 1:1).
      • Detalles de precios (contacte con ventas para Enterprise).
  • Actualice su autenticación a OAuth 2.0:
    • Asegúrese de que su X App tenga los permisos “Read, Write, and Access Direct Messages”.
    • Actualice a OAuth 2.0 para los endpoints v2. Vuelva a autorizar a los usuarios si han cambiado los scopes.
    • Use el portal de desarrolladores para gestionar:
      • OAuth 2.0 Access Token.
      • Client ID y Client Secret.
  • Verifique o reconfigure su webhook:
    • Use su URL de webhook existente o configure una nueva (p. ej., https://your_domain.com/webhook/twitter).
    • Siga la documentación de la Webhooks API v2 para registrar y gestionar su webhook.
  • Apps de ejemplo:
⌘I