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

​
Ferramentas úteis

Antes de abordarmos alguns conceitos essenciais que o ajudarão 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 para ajudar você a entender rapidamente o que está disponível. Para saber mais sobre nossas coleções do Postman, visite a página “Using 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 as bibliotecas de terceiros de nossa comunidade para começar. Você pode encontrar uma biblioteca compatível com os endpoints v2 procurando pela tag de versão adequada.

​
Conceitos-chave

​
Autenticação

Todos os endpoints da X API v2 exigem que você autentique suas solicitações com um conjunto de credenciais, também conhecido 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 a esses 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á 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, ele 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 App e fluxos de autorização em vários dispositivos. O OAuth 2.0 permite escolher 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 compatível 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ê encontrará suas chaves e tokens no seu App de desenvolvedor.  

​
Limites de requisições

Todos os dias, muitos 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, restringindo 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 limite no nível do usuário, o que significa que o usuário autenticado em nome de quem você está fazendo a requisição só pode chamar o endpoint um certo número de vezes em qualquer App de desenvolvedor. Há um limite de 50 requisições por 15 minutos por endpoint para os métodos POST e DELETE. No entanto, com o método GET, o limite é de apenas 15 requisições por 15 minutos.  

​
Campos e expansions

Os endpoints GET da X API v2 permitem que os usuários selecionem exatamente quais dados desejam retornar da API usando um conjunto de ferramentas chamado fields e expansions. O parâmetro expansions permite expandir objetos referenciados no payload. Por exemplo, este endpoint permite obter as seguintes expansions:
  • pinned_tweet_id
O parâmetro fields permite selecionar exatamente quais fields dentro dos diferentes objetos de dados você deseja receber. Esses endpoints retornam principalmente Objetos Post. Por padrão, o Objeto Post retorna os campos id e text. Para receber campos adicionais, como tweet.created_at ou tweet.entities, você precisará solicitar especificamente esses usando um parâmetro fields. Alguns campos importantes que você pode considerar usar na sua integração são nossos dados de enquete, metrics, Post annotations e os campos de ID de conversa. Adicionamos um guia sobre como usar fields e expansions juntos ao nosso dicionário de dados da X API v2. A consulta de bloqueios pode retornar muitos dados. Para garantir que não retornemos resultados demais de uma só vez, usamos paginação. Saiba mais sobre como paginar os resultados.
⌘I