Skip to main content
Esta página cobre ferramentas e conceitos-chave para integrar os endpoints de Retweet.

Ferramentas úteis

Antes de mergulharmos em alguns conceitos-chave que ajudarão você a integrar este endpoint, recomendamos que você se familiarize com:

Postman

O Postman é uma ótima ferramenta que você pode usar para testar um endpoint. Cada requisição do 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 “Usando o Postman”.

Amostras de código

Interessado em começar a usar este endpoint com código na sua linguagem de programação preferida? Temos várias amostras de código diferentes disponíveis que você pode usar como ponto de partida em nossa página do Github.

Bibliotecas de terceiros

Aproveite as bibliotecas de terceiros da nossa comunidade para ajudar você a começar. Você pode encontrar uma biblioteca que funcione 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 requisições com um conjunto de credenciais, também conhecidas como chaves e tokens. Você pode usar OAuth 1.0a User Context ou OAuth 2.0 Bearer Token para autenticar suas requisições ao endpoint de consulta de Retweets. Os endpoints de gerenciar Retweets exigem o uso de OAuth 1.0a User Context, o que significa que você deve usar um conjunto de API keys e access tokens de usuário para fazer uma requisição bem-sucedida. Os access tokens devem estar associados ao usuário em nome do qual você está fazendo a requisição. Se você quiser gerar um conjunto de access tokens para outro usuário, ele deve autorizar ou autenticar seu App usando o fluxo 3-legged OAuth. Observe que o OAuth 1.0a pode ser complicado de usar. Se você não estiver familiarizado com este método de autenticação, recomendamos que use uma biblioteca para autenticar corretamente suas requisições. Observação Se você estiver solicitando os seguintes fields, é necessário OAuth 1.0a User Context:
  • 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

Developer Console, Projects e Apps de desenvolvedor

Para obter um conjunto de credenciais de autenticação que funcione com os endpoints da X API v2, você deve se inscrever em uma conta de desenvolvedor, configurar um Project dentro dessa conta e ter criado um App de desenvolvedor dentro desse Project. Você pode então encontrar suas chaves e tokens dentro do seu App de desenvolvedor.

Rate limits

Todos os dias, muitos milhares de desenvolvedores fazem requisições à X API. Para ajudar a gerenciar o grande volume dessas requisições, rate limits são aplicados em cada endpoint que limitam o número de requisições que você pode fazer em nome do seu app ou em nome de um usuário autenticado. Os endpoints de gerenciar Retweets são limitados a 50 requisições por 15 min (por usuário). Além disso, para o endpoint POST, você está limitado a 300 requisições por janela de 3 horas (por usuário, por app). Com o endpoint de consulta de Retweets, você está limitado a 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 este endpoint.

Fields e expansions

A X API v2 permite que os usuários selecionem exatamente quais dados desejam retornar da API usando um conjunto de ferramentas chamado fields e expansions. O parâmetro expansion permite expandir 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ê gostaria de receber. Estes endpoints entregam principalmente objetos Post. Por padrão, o objeto Post retorna os fields id e text. Para receber fields adicionais como tweet.created_at ou tweet.entities, você terá que solicitá-los especificamente usando um parâmetro fields. Alguns fields importantes que você pode querer considerar usar em sua integração são nossos fields de dados de poll, metrics, Post annotations e conversation ID. Adicionamos um guia sobre como usar fields e expansions juntos ao nosso data dictionary da X API v2.

Exemplos de código

Obter usuários que retweetaram um Post

cURL

Retweetar um Post

cURL