Pular para o conteúdo principal

​
Como integrar aos endpoints de contagem de Posts

Esta página contém informações sobre várias ferramentas e conceitos importantes que você deve conhecer ao integrar os endpoints de contagem de Posts recentes ou de arquivo completo ao seu sistema. Dividimos a página nas seguintes seções:

​
Ferramentas úteis

Antes de começarmos a explorar alguns conceitos-chave, recomendamos usar uma das seguintes ferramentas ou exemplos de código para começar a testar a funcionalidade desses endpoints.

​
Exemplos de código

Quer configurar esses endpoints com código na sua linguagem de programação preferida? Temos vários exemplos de código que você pode usar como ponto de partida na nossa página no GitHub, incluindo um cliente Python.

​
Bibliotecas

Aproveite uma de nossas muitas bibliotecas de terceiros da comunidade para ajudar você a começar. Você pode encontrar uma biblioteca compatível com os endpoints v2 procurando pela tag de versão apropriada.

​
Postman

O Postman é uma ótima ferramenta que você pode usar para testar esses endpoints. Cada requisição no Postman inclui todos os parâmetros do endpoint em questão para ajudar você a entender rapidamente o que está disponível. Para saber mais sobre nossas coleções do Postman, visite a página Usando o Postman.  

​
Conceitos-chave

​
Autenticação

Todos os endpoints da X API v2 exigem que as solicitações sejam autenticadas com um conjunto de credenciais, também conhecido como chaves e tokens. Este endpoint específico requer o uso de OAuth 2.0 Bearer Token, o que significa que você deve enviar um Bearer Token para que a solicitação seja bem-sucedida. Você pode gerar um Bearer Token diretamente em uma App de desenvolvedor ou gerá-lo utilizando o endpoint POST oauth2/token.

​
Portal do desenvolvedor, Projetos e Apps de desenvolvedor

Para trabalhar com quaisquer endpoints da X API v2, você deve ter uma conta de desenvolvedor, configurar um Projeto nessa conta e criar um App de desenvolvedor dentro desse Projeto. Suas chaves e tokens nesse App de desenvolvedor funcionarão para os endpoints de contagem de Posts recentes. Se você quiser usar o endpoint de contagem de Posts de arquivo completo ou utilizar operadores avançados e uma query mais longa, será necessário ter aprovação para acesso Enterprise. Visite nossa seção sobre acesso Enterprise para saber mais.

​
Limites de requisições

Todos os dias, muitos milhares de desenvolvedores fazem solicitações à X API. Para ajudar a gerenciar o volume, limites de requisições são aplicados a cada endpoint, restringindo o número de solicitações que cada desenvolvedor pode fazer em nome de um App ou de um usuário autenticado. Este endpoint tem limite de taxa no nível do App, o que significa que você, desenvolvedor, só pode fazer um determinado número de solicitações a este endpoint em um dado período de tempo a partir de qualquer App (conforme as credenciais que estiver usando). 

​
Criando queries

O principal recurso desses endpoints é o uso de uma única query para filtrar os Posts nos totais entregues a você. Essas queries são compostas por operadores que fazem correspondência com atributos de Post e de usuário, como palavras‑chave da mensagem, hashtags e URLs. Os operadores podem ser combinados em queries com lógica booleana e parênteses para refinar o comportamento de correspondência da query. Você pode consultar nosso guia sobre como criar uma query para saber mais. Para contagens de Posts recentes, não há next_token retornado, o que significa que, independentemente da granularidade, você receberá o volume de Posts dos últimos 7 dias em uma única chamada de API. Para contagens de Posts do arquivo completo, você receberá data dos últimos 30 dias. Para dados com mais de 30 dias, você receberá um next_token, que poderá usar para paginar e obter os dados adicionais. 

​
Criando queries para contagens de Posts

Os endpoints de contagem de Posts aceitam uma única query em uma solicitação GET e retornam um conjunto de contagens históricas de Posts que correspondem à query. As queries são compostas por operadores usados para corresponder a uma variedade de atributos de Posts. 

​
Tabela de conteúdos

⌘I