Saltar al contenido principal

​
Descripción general

El grupo de endpoints de flujo filtrado permite a los desarrolladores filtrar un flujo de Posts públicos. La funcionalidad de este grupo incluye varios endpoints que te permiten crear y administrar reglas y aplicarlas para filtrar un flujo de Posts que devolverá Posts públicos coincidentes. Este grupo de endpoints permite a los usuarios escuchar temas y eventos específicos, monitorear la conversación en torno a competiciones, entender cómo se desarrollan las tendencias y mucho más. Los desarrolladores pueden usar el endpoint de reglas de REST para agregar y eliminar reglas con el fin de filtrar Posts que coincidan con un criterio definido. Estas reglas se pueden crear con operadores que hagan coincidencia con atributos del Post, como palabras clave del mensaje, hashtags y URL. Los operadores y las cláusulas de reglas se pueden combinar con lógica booleana y paréntesis para refinar el comportamiento de coincidencia del filtro. Una vez que hayas agregado un conjunto de reglas, puedes registrar tu webhook, donde X comenzará a entregar objetos Post en formato JSON. Solo recibirás en tu webhook el contenido que coincida con tus reglas. Este endpoint admite Posts editados. Tu webhook recibirá Posts editados que coincidan con uno o más de tus filtros, junto con su historial de ediciones, incluido un arreglo de IDs de Post. Para Posts sin historial de ediciones, este arreglo contendrá un solo ID. Para Posts que hayan sido editados, este arreglo contiene múltiples IDs, ordenados de forma ascendente que refleja el orden de las ediciones, con la versión más reciente en la última posición del arreglo. Para obtener más información sobre cómo funcionan las ediciones de Posts, consulta la página Fundamentos de edición de Posts. Nota: Este grupo de endpoints es similar al endpoint de flujo filtrado v2 para configurar tus reglas. La única diferencia son los mecanismos de entrega de los Posts que coinciden con tus reglas.
  • En el caso del endpoint de flujo filtrado v2, debes establecer una conexión persistente y escuchar los Posts que coincidan con tus reglas.
  • En el caso de este endpoint de webhook de flujo filtrado, registras tu webhook y X entrega a tu webhook los Posts que coincidan con tus reglas.
Esto elimina la necesidad de gestionar desconexiones derivadas de caídas del cliente o caídas del lado del servidor por reinicios normales de nuestro servicio. Dado que probablemente entregaremos cientos de eventos por segundo, es necesario que tu servidor de webhooks pueda manejar estos intentos de conexión simultáneos. Este endpoint está actualmente disponible para desarrolladores del plan Empresarial y admite la siguiente configuración:
  • 25,000+ reglas por proyecto
  • Puedes usar todos los operadores al crear tu regla
  • Puedes crear reglas de hasta 2048 caracteres de longitud
  • Solicita acceso aquí para el plan Empresarial
Los Posts devueltos por el flujo filtrado cuentan para el límite mensual de Posts.
Configuración de la cuentaPara acceder a estos endpoints, necesitarás:Obtén más información sobre cómo obtener acceso a los endpoints de X API v2 en nuestra guía de inicio.