Pular para o conteúdo principal
Esta página contém informações sobre diversas ferramentas e conceitos fundamentais que você deve conhecer ao integrar os endpoints de mutes ao seu sistema. Dividimos a página em algumas seções:

​
Ferramentas úteis

Antes de abordarmos alguns conceitos fundamentais que ajudarão você a integrar este endpoint, recomendamos que você se familiarize com:

​
Postman

O Postman é uma excelente ferramenta para testar um endpoint. Cada requisição no Postman inclui todos os parâmetros de caminho e de corpo, ajudando você a entender rapidamente o que está disponível. Para saber mais sobre nossas coleções no Postman, visite a página “Usando o Postman”. 

​
Exemplos de código

Quer começar a usar este endpoint com código na sua linguagem de programação preferida? Temos diversos exemplos de código disponíveis que você pode usar como ponto de partida na nossa página no GitHub.

​
Bibliotecas de terceiros

Aproveite uma das bibliotecas de terceiros da nossa comunidade para começar. Você pode encontrar uma biblioteca compatível com os endpoints v2 procurando a tag de versão adequada.

​
Conceitos essenciais

​
Autenticação

Todos os endpoints da X API v2 exigem que você autentique suas solicitações com um conjunto de credenciais, também conhecidas como chaves e tokens. Você pode usar o Contexto de Usuário do OAuth 1.0a ou o OAuth 2.0 Authorization Code com PKCE para autenticar suas solicitações nesses endpoints. Contexto de Usuário do OAuth 1.0a exige que você utilize suas API Keys, Access Tokens de usuário e alguns outros parâmetros para criar um cabeçalho de autorização, que você então enviará junto com sua solicitação. Os Access Tokens devem estar associados ao usuário em nome de quem você está fazendo a solicitação. Se você quiser gerar um conjunto de Access Tokens para outro usuário, essa pessoa deverá autorizar sua App usando o fluxo OAuth de 3 etapas. Observe que o OAuth 1.0a pode ser difícil de usar. Se você não estiver familiarizado com esse método de autenticação, recomendamos usar uma biblioteca, uma ferramenta como o Postman ou o OAuth 2.0 para autenticar suas solicitações. OAuth 2.0 Authorization Code com PKCE permite maior controle sobre o escopo de uma aplicação e fluxos de autorização em vários dispositivos. O OAuth 2.0 permite que você selecione escopos específicos e granulares que concedem permissões específicas em nome de um usuário. Para habilitar o OAuth 2.0 na sua App, você deve ativá-lo nas configurações de autenticação da sua App, localizadas na seção de configurações da App no portal do desenvolvedor.

​
Portal do desenvolvedor, Projetos e Apps de desenvolvedor

Para obter um conjunto de credenciais de autenticação que funcionem com os endpoints da X API v2, você deve criar uma conta de desenvolvedor, configurar um Projeto nessa conta e criar um App de desenvolvedor dentro desse Projeto. Em seguida, você poderá encontrar suas chaves e tokens no seu App de desenvolvedor.  

​
Limites de requisições

Todos os dias, milhares de desenvolvedores fazem requisições à X API. Para ajudar a gerenciar o grande volume dessas requisições, limites de requisições são aplicados a cada endpoint, limitando o número de requisições que você pode fazer em nome da sua App ou de um usuário autenticado.  Esses endpoints têm limites no nível do usuário, o que significa que o usuário autenticado em cujo nome você está fazendo a requisição só pode chamar o endpoint um determinado número de vezes em qualquer App de desenvolvedor. Há um limite por usuário de 50 requisições por 15 minutos, por endpoint, para os métodos POST e DELETE. No entanto, para o método GET, o limite é de apenas 15 requisições por 15 minutos.  

​
Campos e expansions

O endpoint GET da X API v2 permite que os usuários selecionem exatamente quais dados desejam obter da API usando um conjunto de recursos chamados fields e expansions. O parâmetro expansions permite incluir (expandir) objetos referenciados no payload. Por exemplo, este endpoint permite buscar as seguintes expansions:
  • pinned_tweet_id
O parâmetro fields permite selecionar exatamente quais fields dentro dos diferentes objetos de dados você deseja receber. Este endpoint entrega principalmente objetos de usuário. Por padrão, o objeto de usuário retorna os campos id, name e username. Para receber campos adicionais, como user.created_at ou user.entities, você precisará solicitá-los especificamente usando o parâmetro fields. Adicionamos um guia sobre como usar fields e expansions em conjunto ao nosso X API v2 data dictionary. A pesquisa de silenciamentos pode retornar muitos dados. Para garantir resultados consistentes e com alto desempenho a qualquer momento, usamos paginação. A paginação é um recurso dos endpoints da X API v2 que retornam mais resultados do que podem ser incluídos em uma única resposta. Quando isso acontece, o campo data é retornado em uma série de “páginas”. Saiba mais sobre como paginar os resultados.
Atenção: Se um usuário silenciar pelo X, há um limite de 200 solicitações a cada 15 minutos.
⌘I