API de webhooks del stream filtrado

​

Descripción general

El grupo de endpoints de stream filtrado permite a los desarrolladores filtrar un stream de Posts públicos. La funcionalidad de este grupo de endpoints incluye múltiples endpoints que permiten crear y administrar reglas, y aplicar esas reglas para filtrar un stream de Posts que devolverá Posts públicos que coincidan. 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 de REST rules para agregar y eliminar reglas con el fin de filtrar Posts que coincidan con criterios definidos. Estas rules se pueden crear con operadores que hagan coincidir atributos del Post, como palabras clave del mensaje, hashtags y URL. Los operadores y las cláusulas de las 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 de Post en formato JSON. Solo recibirás en tu webhook 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 único ID. Para Posts que han sido editados, este arreglo contiene múltiples IDs, ordenados de forma ascendente según 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 ediciones de Posts.

Nota: Este grupo de endpoints es similar al endpoint de stream filtrado de 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 stream filtrado de 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 stream filtrado, registras tu webhook y X entrega los Posts que coinciden con tus reglas a tu webhook.

Esto elimina la necesidad de manejar desconexiones derivadas de caídas del cliente o caídas del lado del servidor por reinicios normales de nuestro servicio. Dado que probablemente estaremos entregando cientos de eventos por segundo, es necesario que tu servidor de webhook pueda manejar estos intentos de conexión simultáneos.

Este endpoint está disponible actualmente para desarrolladores de Enterprise y admite la siguiente configuración:

• Más de 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 para Enterprise aquí

Los Posts devueltos del stream filtrado cuentan para el Post cap mensual.

Configuración de la cuenta

Para acceder a estos endpoints, necesitarás:

• Una cuenta de desarrollador aprobada.
• Autenticarte usando las keys and tokens de una App de desarrollador que se encuentra dentro de un Project.

Obtén más información sobre cómo obtener acceso a los endpoints de X API v2 en nuestra guía de inicio.

Guía rápida