Saltar al contenido principal
Esta guía te ayuda a migrar desde la Enterprise Account Activity API heredada a la Account Activity API v2. La funcionalidad principal sigue siendo la misma, pero las estructuras de los endpoints y los métodos de autenticación se han actualizado a fin de mantener la coherencia con 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/.
  • Administración de webhooks: La creación, listado, validación (CRC) y eliminación de webhooks se gestionan mediante la V2 Webhooks API.
  • Autenticación: Los endpoints de V2 requieren cualquiera de las siguientes opciones:
    • OAuthUser (3-legged OAuth) para acciones específicas de usuario (por ejemplo, suscribir a un usuario).
    • OAuth2 App Only (Bearer Token) para acciones a nivel de App (por ejemplo, listar/eliminar suscripciones).
    • V1.1 utilizaba requisitos variables, a menudo OAuth 1.0a.
  • Asignación de endpoints:
Endpoint V1.1Acción / equivalente en V2Notas
POST /1.1/account_activity/webhooks.json?url=<URL>POST /2/webhooksDocs. Requiere OAuth2 App Only.
GET /1.1/account_activity/webhooks.jsonGET /2/webhooksDocs. Requiere OAuth2 App Only.
PUT /1.1/account_activity/webhooks/:webhook_id.jsonPUT /2/webhooks/:webhook_idActiva el CRC. Docs. Requiere OAuth2 App Only.
DELETE /1.1/account_activity/webhooks/:webhook_id.jsonDELETE /2/webhooks/:webhook_idDocs. Requiere OAuth2 App Only.
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 OAuth2 App Only.
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 OAuth2 App Only.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allDELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/allRequiere OAuth2 App Only.
DELETE /1.1/account_activity/webhooks/:webhook_id/subscriptions/allObsoleto / sin equivalente directoUtilice 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 administre los webhooks utilizando la V2 Webhooks API.

​
Cómo migrar

  • Elige un paquete:
    • Elige el paquete Enterprise o Self-serve 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 frente a soporte empresarial gestionado 1:1).
      • Detalles de precios (contacta con el equipo de ventas para Enterprise).
  • Actualiza tu autenticación a OAuth 2.0:
    • Asegúrate de que tu App de X tenga permisos de “Read, Write, and Access Direct Messages”.
    • Actualiza a OAuth 2.0 para los endpoints V2. Vuelve a autorizar a los usuarios si los permisos (scopes) han cambiado.
    • Usa la Consola de desarrollador para gestionar:
      • OAuth 2.0 Access Token.
      • Client ID y Client Secret.
  • Verifica o vuelve a configurar tu webhook:
    • Usa tu URL de webhook existente o configura una nueva (por ejemplo, https://your_domain.com/webhook/twitter).
    • Sigue la documentación de V2 Webhooks API para registrar y gestionar tu webhook.
  • Aplicaciones de ejemplo: