Saltar al contenido principal

​
Guía de migración de la API de actividad de cuentas v2

Esta guía le ayuda a migrar de la API de actividad de cuentas Empresarial heredada a la API de actividad de cuentas v2. La funcionalidad principal sigue siendo la misma, pero se han actualizado las estructuras de los endpoints y los métodos de autenticación para 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/.
  • Gestión de webhooks: La creación, el listado, la validación (CRC) y la eliminación de webhooks se gestionan con la V2 Webhooks API.
  • Autenticación: Los endpoints de V2 requieren uno de los siguientes métodos:
    • OAuthUser (OAuth de 3 fases) para acciones específicas del 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 tenía requisitos variables, a menudo OAuth 1.0a.
  • Asignación de endpoints:
Endpoint 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 quite el webhook mediante DELETE /2/webhooks/:webhook_id.
  • Formatos de respuesta: Revise las estructuras de respuestas de éxito y de 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 con la V2 Webhooks API.

​
Cómo migrar

  • Elige un paquete:
    • Selecciona el paquete Empresarial o Pro para acceder a Account Activity API, teniendo en cuenta:
      • Número de webhooks necesarios.
      • Suscripciones o usuarios autorizados actuales y proyectados.
      • Número de aplicaciones cliente de X.
      • Nivel de soporte deseado (foro vs. soporte empresarial gestionado 1:1).
      • Detalles de precios (contacta con Ventas para Empresarial).
  • Actualiza tu Autenticación a OAuth 2.0:
    • Asegúrate de que tu App de X tenga permisos de “Leer, escribir y acceder a Mensajes Directos”.
    • Actualiza a OAuth 2.0 para los endpoints de la V2. Vuelve a autorizar a los usuarios si cambiaron los scopes.
    • Usa el Portal de desarrolladores para gestionar:
      • Token de acceso de OAuth 2.0.
      • Client ID y Client Secret.
  • Verifica o reconfigura tu webhook:
    • Usa tu URL de webhook existente o configura una nueva (p. ej., https://your_domain.com/webhook/twitter).
    • Sigue la documentación de la API de webhooks V2 para registrar y administrar tu webhook.
  • Apps de ejemplo: