Pular para o conteúdo principal

​
Introdução aos endpoints de gerenciamento de Retweets

Este guia de Início rápido ajudará você a fazer sua primeira solicitação aos endpoints de gerenciamento de Retweets usando o Postman. Se você deseja ver código de exemplo em diferentes linguagens, visite nosso repositório no GitHub X API v2 sample code. 

​
Pré-requisitos

Para concluir este guia, você precisará de um conjunto de chaves e tokens para autenticar sua solicitação. Você pode gerá-los seguindo estas etapas:

​
Etapas para criar uma solicitação para gerenciar Retweets

Etapa um: comece com uma ferramenta ou biblioteca Há várias ferramentas, exemplos de código e bibliotecas que você pode usar para fazer uma solicitação a este endpoint, mas aqui vamos usar o Postman para simplificar o processo. Para carregar a coleção do Postman da X API v2 no seu ambiente, clique no botão a seguir:
Depois que a coleção da X API v2 estiver carregada no Postman, navegue até a pasta “Retweets” e selecione “Retweet a Post”.   Etapa dois: autentique sua solicitação Para fazer corretamente uma solicitação à X API, você precisa verificar se tem permissão. Para isso, neste endpoint, você deve autenticar sua solicitação usando OAuth 1.0a User Context ou OAuth 2.0 Authorization Code with PKCE. Neste exemplo, vamos usar OAuth 1.0a User Context. Você deve adicionar suas chaves e tokens – especificamente sua API Key, API Secret Key, OAuth 1.0a user Access Token e OAuth 1.0a user Access Token Secret – ao Postman. Faça isso selecionando o ambiente chamado “X API v2” no canto superior direito do Postman e adicionando suas chaves e tokens nos campos “initial value” e “current value” (clicando no ícone de olho ao lado do menu suspenso de ambientes). Essas variáveis serão automaticamente inseridas na guia de autorização da solicitação se você fez isso corretamente. Etapa três: especifique qual Post você vai Retweetar Os endpoints de gerenciamento de Retweets exigem dois IDs: um para o usuário que deseja Retweetar ou desfazer um Retweet e o id do Post. O ID do usuário deve corresponder ao ID do usuário autenticado, o que significa que você deve passar os Tokens de Acesso associados ao ID de usuário ao autenticar sua solicitação. Neste caso, você pode especificar o ID do seu próprio usuário. Você pode encontrar seu ID de duas maneiras:
  1. Usando o endpoint user lookup by username, você pode passar um nome de usuário e receber o campo id.
  2. Observando seu Access Token, você verá que a parte numérica é o seu ID de usuário.  
Você também deve especificar um Post que deseja Retweetar. Você pode encontrar o ID do Post navegando em X.com, clicando em um Post e, em seguida, consultando a URL. Por exemplo, o ID do Post da seguinte URL é 1228393702244134912. https://x.com/TwitterDev/status/1228393702244134912 No Postman, navegue até a guia “Params” e insira seu ID na coluna “Value” da variável de caminho id, e insira o ID do Post que você deseja Retweetar como valor do parâmetro tweet_id. Certifique-se de não incluir espaços antes ou depois de qualquer ID.
KeyValue
id(seu ID de usuário)
tweet_id(o ID do Tweet que você quer Retweetar)
Se você clicar no botão “Send”, receberá um objeto de resposta contendo o status do relacionamento:
  • Se você receber “retweeted”: true, então o id está Retweetando com sucesso o tweet_id.  
Etapa quatro: faça sua solicitação e revise sua resposta Depois que tudo estiver configurado, clique no botão “Send” e você receberá a seguinte resposta: 
{
    "data": {
        "retweetado": true
    }
}
Se você receber "retweeted": true, significa que o Retweet do tweet_id foi realizado com sucesso. Se você desejar desfazer um Retweet pelo mesmo usuário, pode usar a requisição intitulada “Undo a Retweet”, que também está na pasta “Retweets” da coleção X API v2 carregada no Postman. O id deve ser o seu ID de usuário e source_tweet_id deve ser o ID do Post do qual deseja desfazer o Retweet. Você não precisará enviar isso no corpo JSON; portanto, certifique-se de incluir os parâmetros de consulta necessários para id e source_tweet_id.  Ao desfazer um Retweet com sucesso, você receberá uma resposta semelhante ao exemplo a seguir: 
{
  "data": {
    "retweeted": false
  }
}