Pular para o conteúdo principal
Esta página reúne informações sobre várias ferramentas e conceitos essenciais que você deve conhecer ao integrar os endpoints de Retweet ao seu sistema. Organizamos o conteúdo nas seguintes 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 que você pode usar para testar um endpoint. Cada requisição no Postman inclui todos os parâmetros de caminho e de corpo para ajudá-lo a entender rapidamente o que está disponível para você. Para saber mais sobre nossas coleções do Postman, visite a página “Usando o Postman”. 

​
Exemplos de código

Interessado em configurar este endpoint com código na sua linguagem de programação preferida? Temos vários 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 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 OAuth 1.0a User Context ou OAuth 2.0 Bearer Token para autenticar suas solicitações ao endpoint de consulta de Retweets. Os endpoints de gerenciamento de Retweets exigem o uso de OAuth 1.0a User Context, o que significa que você deve usar um conjunto de API Keys e tokens de acesso de usuário para fazer uma solicitação bem-sucedida. 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 ou autenticar seu App usando o fluxo OAuth de 3 etapas. Observe que o OAuth 1.0a pode ser complexo de usar. Se você não estiver familiarizado com esse método de autenticação, recomendamos usar uma biblioteca para autenticar suas solicitações corretamente. Observação Se você estiver solicitando os seguintes fields, OAuth 1.0a User Context é obrigatório:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
Portal do desenvolvedor, Projetos e Apps de desenvolvedor

Para obter um conjunto de credenciais de autenticação que funcione com os endpoints da X API v2, você deve inscrever-se em uma conta de desenvolvedor, configurar um Projeto nessa conta e criar um App de desenvolvedor nesse Projeto. Em seguida, você poderá 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. Os endpoints de gerenciamento de Retweets são limitados a 50 requisições por 15 min (por usuário). Além disso, para o endpoint POST, o limite é de 300 requisições por janela de 3 horas (por usuário, por App). Com o endpoint de consulta de Retweets, o limite é de 75 requisições por janela de 15 min. Além disso, apenas os 100 usuários que fizeram Retweet mais recentemente serão retornados por esse endpoint.

​
Campos e expansions

A X API v2 permite que os usuários selecionem exatamente quais dados desejam obter da API usando um conjunto de ferramentas chamado fields e expansions. O parâmetro expansion permite incluir objetos referenciados no payload. Por exemplo, este endpoint permite obter as seguintes expansions:
  • attachments.poll_ids
  • attachments.media_keys
  • author_id, entities.mentions.username
  • geo.place_id
  • in_reply_to_user_id,
  • referenced_tweets.id,
  • referenced_tweets.id.author_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á solicitá-los especificamente usando um parâmetro fields. Alguns campos importantes que você pode considerar usar na sua integração são nossos dados de enquetes, metrics, Post annotations e campos de ID de conversa. Adicionamos um guia sobre como usar fields e expansions em conjunto ao nosso dicionário de dados da X API v2.
⌘I