Saltar al contenido principal
El grupo de puntos de conexión de la X Activity API (XAA) permite a los desarrolladores aprovechar los eventos de actividad que ocurren en la plataforma de X. Un desarrollador puede suscribirse a eventos de su interés, como ProfileBioUpdate, ProfilePictureUpdate, etc., y filtrar por el ID de usuario cuyos eventos desea recibir. Los eventos que coincidan para ese ID de usuario se entregarán a tu aplicación con una latencia inferior a un segundo.
La X Activity API está disponible como beta abierta. Mientras esté en beta abierta, espera posibles errores, cambios incompatibles o funciones incompletas.Tus comentarios son muy valiosos: informa de los problemas a través de nuestros foros de la comunidad de desarrolladores.

​
Mecanismos de entrega

La X Activity API actualmente admite los siguientes mecanismos para enviar eventos a tu aplicación:
  • Transmisión HTTP persistente
  • Webhook

​
Tipos de eventos compatibles

Actualmente, la X Activity API admite los siguientes eventos de actualización de perfil:
CategoríaNombre del eventoDescripción
PerfilProfileBioUpdateSe activa cuando un usuario actualiza la biografía de su perfil
PerfilProfilePictureUpdateSe activa cuando un usuario actualiza la foto de su perfil
PerfilProfileBannerUpdateSe activa cuando un usuario actualiza el banner de su perfil
PerfilProfileGeoUpdateSe activa cuando un usuario actualiza la ubicación de su perfil
PerfilProfileUrlUpdateSe activa cuando un usuario actualiza la URL del sitio web de su perfil
PerfilProfileScreennameUpdateSe activa cuando un usuario actualiza su nombre para mostrar
PerfilProfileVerifiedBadgeUpdateSe activa cuando un usuario actualiza su insignia de verificación
En próximas versiones, XAA se ampliará para admitir tipos de eventos adicionales, como interacciones sociales, participación en el contenido, funciones de monetización y más. Seguiremos actualizando nuestra documentación cuando haya nuevos tipos de eventos disponibles.
Nota: XAA no entrega Publicaciones. Para la entrega de Publicaciones en tiempo real, consulta nuestro punto de conexión Filtered Stream, que permite a los desarrolladores filtrar y transmitir Publicaciones en tiempo real.

​
Privacidad de eventos y autenticación

La X Activity API distingue entre eventos públicos y eventos privados de forma coherente con la aplicación de X, como se explica a continuación.

​
Eventos públicos

Los eventos públicos son actividades que una cuenta de usuario pública realiza de forma visible para todos los usuarios de X. Estos eventos se muestran a todos los usuarios en la plataforma de X y no requieren autenticación OAuth del usuario para poder verlos. Eventos públicos actuales:
  • Actualizaciones de perfil (biografía, imagen, banner, ubicación, URL, cambios de nombre de usuario)
Para estos eventos públicos, puedes crear suscripciones especificando el id de usuario en tu filtro y recibirlas a través de XAA.

​
Eventos privados

Los eventos privados son actividades que requieren el consentimiento explícito del usuario mediante autenticación con OAuth. El usuario debe autenticarse en X y otorgar permiso explícito a una App para desarrolladores para acceder a estos eventos. Requisitos de autenticación para eventos privados:
  • El usuario debe autenticar tu aplicación mediante OAuth 2.0
  • Tu aplicación debe obtener los ámbitos (scopes) de OAuth adecuados
  • El usuario debe otorgar explícitamente permiso para que tu aplicación acceda a estos eventos
  • Las suscripciones a eventos privados solo pueden crearse para usuarios que hayan autorizado tu aplicación

​
Límites de suscripción

La X Activity API tiene diferentes límites de suscripción según tu nivel de cuenta:
Nivel del paqueteMáximo de suscripciones
GratisNo disponible
Basic50
Pro2500
Enterprise20,000
Partner100,000
Configuración de la cuentaPara acceder a estos puntos de conexión, necesitarás:Obtén más información sobre cómo acceder a los puntos de conexión de X API v2 en nuestra guía de introducción.