Filtered Stream Webhooks API

​

Descripción general

El grupo de endpoints filtered stream permite a los desarrolladores filtrar un stream de Posts públicos. La funcionalidad de este grupo de endpoints incluye múltiples endpoints que te permiten crear y gestionar rules, y aplicar esas rules para filtrar un stream 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 competencias, comprender cómo se desarrollan las tendencias y mucho más. Los desarrolladores pueden usar el endpoint REST de rules para agregar y eliminar rules que filtren Posts que coincidan con un criterio definido. Estas rules pueden crearse con operadores que coincidan con atributos de Post como palabras clave del mensaje, hashtags y URLs. Los operadores y las cláusulas de rule pueden combinarse con lógica booleana y paréntesis para ayudar a refinar el comportamiento de coincidencia del filtro. Una vez que hayas añadido un conjunto de rules, puedes registrar tu webhook y X comenzará a entregar objetos Post en formato JSON. Solo recibirás en tu webhook el contenido que coincida con tus rules. Este endpoint soporta Posts editados. Tu webhook recibirá Posts editados que coincidan con uno o más de tus filtros, junto con su historial de ediciones, incluyendo un arreglo de Post IDs. Para Posts sin historial de ediciones, este arreglo contendrá un único ID. Para Posts que han sido editados, este arreglo contiene múltiples IDs, ordenados en orden ascendente reflejando el orden de las ediciones, con la versión más reciente en la última posición del arreglo. Para saber más sobre cómo funcionan las ediciones de Post, consulta la página de fundamentos de ediciones de Post. Nota: Este grupo de endpoints es similar al endpoint filtered stream de v2 para configurar tus rules. La única diferencia son los mecanismos de entrega para los Posts que coinciden con tus rules.

• En el caso del endpoint filtered stream de v2, tienes que establecer una conexión persistente y escuchar los Posts que coincidan con tus rules.
• En el caso de este endpoint filtered stream webhook, registras tu webhook y X entrega los Posts que coinciden con tus rules a tu webhook.

Esto elimina la necesidad de manejar las desconexiones derivadas de caídas del cliente o del lado del servidor por reinicios normales de nuestro servicio. Dado que probablemente estaremos entregando cientos de eventos/segundo, es necesario que tu servidor de webhook pueda manejar estos intentos de conexión simultáneos. Este endpoint está actualmente disponible para desarrolladores Enterprise y soporta la siguiente configuración:

• Más de 25.000 rules por project
• Se pueden usar todos los operadores al construir tu rule
• Se pueden construir rules de hasta 2048 caracteres de longitud
• Solicita aquí el acceso Enterprise

Los Posts devueltos por filtered stream cuentan para el Post cap mensual.