Pular para o conteúdo principal

​
Visão geral

O grupo de endpoints do stream filtrado permite que desenvolvedores filtrem um stream de Posts públicos. A funcionalidade desse grupo inclui vários endpoints que permitem criar e gerenciar regras e aplicá-las para filtrar um stream de Posts que retornará Posts públicos correspondentes. Esse grupo também permite acompanhar tópicos e eventos específicos, monitorar a conversa sobre competições, entender como as tendências se desenvolvem e muito mais. Os desenvolvedores podem usar o endpoint REST de regras para adicionar e remover regras que filtrem Posts de acordo com critérios definidos. Essas regras podem ser criadas com operadores que fazem correspondência com atributos do Post, como palavras-chave da mensagem, hashtags e URLs. Operadores e cláusulas de regra podem ser combinados com lógica booleana e parênteses para refinar o comportamento de correspondência do filtro. Depois de adicionar um conjunto de regras, você pode registrar seu webhook, para o qual a X passará a entregar Objetos Post em formato JSON. Você receberá no seu webhook apenas conteúdo que corresponda às suas regras. Este endpoint oferece suporte a Posts editados. Seu webhook receberá Posts editados que correspondam a um ou mais de seus filtros, juntamente com o respectivo histórico de edições, incluindo um array de IDs do Post. Para Posts sem histórico de edições, esse array conterá um único ID. Para Posts que foram editados, esse array conterá vários IDs, organizados em ordem ascendente, refletindo a sequência de edições, com a versão mais recente na última posição do array. Para saber mais sobre como funcionam as edições de Post, consulte a página Fundamentos de edições de Posts. Observação: Este grupo de endpoints é semelhante ao endpoint de stream filtrado v2 para a configuração de regras. A única diferença está nos mecanismos de entrega dos Posts que correspondem às suas regras.
  • No endpoint de stream filtrado v2, é necessário estabelecer uma conexão persistente e ouvir pelos Posts que correspondem às suas regras.
  • No endpoint de webhook do stream filtrado, você registra seu webhook, e a X entrega os Posts que correspondem às suas regras ao seu webhook.
Isso elimina a necessidade de lidar com desconexões decorrentes de quedas no cliente ou do lado do servidor, causadas por reinicializações normais do nosso serviço. Como provavelmente entregaremos centenas de eventos por segundo, é necessário que o seu servidor de webhook consiga lidar com essas tentativas de conexão simultâneas. Este endpoint está atualmente disponível para desenvolvedores Enterprise e oferece suporte à seguinte configuração:
  • 25.000+ regras por projeto
  • Uso de todos os operadores ao criar suas regras
  • Regras com até 2048 caracteres
  • Solicite acesso Enterprise aqui
Os Posts retornados do stream filtrado contam para o Post cap mensal.
Configuração de contaPara acessar esses endpoints, você precisará de:Saiba mais sobre como obter acesso aos endpoints da X API v2 em nosso guia de introdução.
⌘I