Pular para o conteúdo principal

​
Introdução aos endpoints de gerenciamento de Bookmarks

Este guia de introdução rápida ajudará você a fazer sua primeira solicitação aos endpoints de gerenciamento de Bookmarks usando o Postman. Se você quiser ver exemplos de código em diferentes linguagens, visite nosso repositório no GitHub: X API v2 sample code. 
Pré-requisitosPara concluir este guia, você precisará de um conjunto de chaves e tokens para autenticar sua solicitação. Você pode gerar essas chaves e tokens seguindo estas etapas:

​
Etapas para criar uma solicitação de gerenciamento de Bookmarks

Primeira etapa: 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 vamos usar o Postman aqui para simplificar o processo. Para carregar a coleção do X API v2 no seu ambiente do Postman, clique no botão a seguir:
Depois que a coleção do X API v2 estiver carregada no Postman, navegue até a pasta “Bookmarks” e selecione “Create a Bookmark”. Segunda etapa: autentique sua solicitação Para fazer uma solicitação bem-sucedida a este endpoint, você precisará usar OAuth 2.0 Authorization Code Flow with PKCE. Você pode gerar um access token no Postman. Vá até a guia “Authorization” e selecione “OAuth 2.0”. Nesta guia, certifique-se de seguir estas etapas:
  1. Dê um nome ao seu token
  2. Selecione o Grant Type como Authorization Code (with PKCE)
  3. Atualize os parâmetros: Callback URL - https://www.example.com Isso deve corresponder ao Callback URL que você definiu na página de configurações de autenticação no portal do desenvolvedor. Auth URL - https://x.com/i/oauth2/authorize Access Token URL - https://api.x.com/2/oauth2/token Client ID - Copie e cole o OAuth 2.0 client ID do portal do desenvolvedor Client Secret - Copie e cole o OAuth 2.0 client ID do portal do desenvolvedor. Você só precisará disso se estiver usando um tipo de App que seja um cliente confidencial.
  4. Atualize os escopos com os seguintes valores: post.read users.read bookmark.write
  5. Preencha o campo state com “State”
  6. Clique em “Generate Token”
  7. Clique no ícone de salvar para gravar as alterações na pasta.
Você pode receber uma mensagem informando que não está conectado ao X. Se receber esse erro, será necessário fazer login na conta do X, dentro do Postman, em nome da qual você está tentando publicar. Terceira etapa: especifique um usuário Com este endpoint, você deve especificar o ID do usuário cujos seguidores deseja receber na resposta. Por exemplo, o ID do usuário para @XDevelopers é 2244994945. No Postman, navegue até a guia “Params” e insira o ID seu ou de um usuário autenticado como o valor do parâmetro id.
KeyValue
id2244994945
Quarta etapa: especifique um Post que você deseja adicionar aos Bookmarks Vá até a guia “Body” e verifique se o ID do Post está definido para aquele que você deseja salvar nos seus Bookmarks. O payload JSON deve ser semelhante ao abaixo. 
      {"tweet_id": "1460323737035677698"}
Passo cinco: Faça sua solicitação e revise a resposta Depois que tudo estiver configurado, clique no botão “Send” e você receberá uma resposta semelhante ao exemplo a seguir: 
{
   "data": {
       "bookmarked": true
   }
}
Para excluir um Post, selecione a solicitação “Remove a Bookmark”, também localizada na pasta “Bookmarks” da coleção X API v2 carregada no Postman. Primeiro, especifique o id do usuário em nome de quem você está fazendo a solicitação como o valor da coluna “id”. Este endpoint também requer o id do Post que você deseja excluir. Em seguida, na guia “Params”, insira o id do Post que você deseja excluir como o valor da coluna “tweet_id”.  Quando você realizar uma solicitação DELETE bem-sucedida, receberá uma resposta semelhante ao exemplo a seguir: 
{
   "data": {
       "bookmarked": false
   }
}
⌘I