Filtered Stream Webhooks API

​

Visão geral

O grupo de endpoints filtered stream permite que desenvolvedores filtrem um stream de Posts públicos. A funcionalidade desse grupo de endpoints inclui múltiplos endpoints que permitem criar e gerenciar regras, e aplicar essas regras para filtrar um stream de Posts que retornará Posts públicos correspondentes. Este grupo de endpoints permite que usuários escutem tópicos e eventos específicos, monitorem a conversa em torno de competições, entendam como tendências se desenvolvem e muito mais. Desenvolvedores podem usar o endpoint REST de rules para adicionar e remover regras a fim de filtrar Posts que correspondam a critérios definidos. Essas regras podem ser criadas com operadores que correspondem a atributos de Post, como palavras-chave da mensagem, hashtags e URLs. Operadores e cláusulas de regras podem ser combinados com lógica booleana e parênteses para ajudar a refinar o comportamento de correspondência do filtro. Depois de adicionar um conjunto de regras, você pode registrar seu webhook, onde o X começará a entregar objetos Post no formato JSON. Você receberá apenas conteúdo correspondente às suas regras no seu webhook. Este endpoint oferece suporte a Posts editados. Seu webhook receberá Posts editados que correspondem a um ou mais dos seus filtros, junto com seu edit history, incluindo um array de Post IDs. Para Posts sem histórico de edição, esse array terá um único ID. Para Posts que foram editados, esse array contém múltiplos IDs, dispostos em ordem crescente refletindo a ordem das edições, com a versão mais recente na última posição do array. Para saber mais sobre como as edições de Post funcionam, consulte a página Posts edits fundamentals. Observação: Este grupo de endpoints é semelhante ao endpoint v2 filtered stream para configurar suas regras. A única diferença são os mecanismos de entrega dos Posts que correspondem às suas regras.

• No caso do endpoint v2 filtered stream, você precisa estabelecer uma conexão persistente e escutar os Posts correspondentes às suas regras.
• No caso deste endpoint filtered stream webhook, você registra seu webhook, e o X entrega os Posts correspondentes às suas regras ao seu webhook.

Isso elimina a necessidade de lidar com desconexões decorrentes de quedas do client ou quedas no lado do servidor por reinícios normais do nosso serviço. Como provavelmente entregaremos centenas de eventos/segundo, é necessário que seu servidor de webhook seja capaz de lidar com essas tentativas de conexão simultâneas. Este endpoint está atualmente disponível para desenvolvedores Enterprise e suporta a seguinte configuração:

• Mais de 25.000 regras por projeto
• Pode usar todos os operadores ao construir sua regra
• Pode construir regras de até 2048 caracteres
• Solicite acesso Enterprise aqui

Os Posts retornados pelo filtered stream contam para o Post cap mensal.