Pular para o conteúdo principal

​
Introdução ao endpoint de consulta de Bookmarks

Este guia de Introdução rápida vai ajudar você a fazer sua primeira requisição ao endpoint de consulta de Bookmarks usando o Postman. Visite nosso repositório no GitHub X API v2 sample code se você quiser ver exemplos de código em diferentes linguagens.

​
Pré-requisitos

Para 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 busca de Bookmarks

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 usaremos 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 “Bookmarks lookup”. Etapa dois: autentique sua solicitação Para fazer uma solicitação bem-sucedida a este endpoint, você precisará usar o 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, siga estas etapas:
  1. Dê um nome ao token
  2. Selecione o Grant Type como Authorization Code (with PKCE)
  3. Atualize os parâmetros: Callback URL - https://www.example.com Ele deve corresponder ao callback URL definido na sua 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.read
  5. Preencha o campo state com “State”
  6. Clique em “Generate Token”
  7. Clique no ícone de salvar para salvar 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. Etapa três: especifique um usuário Com este endpoint, você deve especificar o user ID cujos seguidores deseja receber na resposta. Por exemplo, o user ID de @XDevelopers é 2244994945. No Postman, navegue até a guia “Params” e insira o id seu ou de um usuário autenticado como valor para o parâmetro id.
KeyValue
id2244994945
Etapa quatro: faça sua solicitação e revise sua resposta Depois de configurar tudo, clique no botão “Send” e você receberá uma resposta semelhante ao exemplo a seguir: 
{
   "data": [
       {
           "id": "1501258597237342208",
           "text": "🗣 Você desenvolveu um projeto usando a X API que gostaria de compartilhar com a comunidade? Adoraríamos saber mais. Compartilhe seu projeto conosco!"
       },
       {
           "id": "1501258542258348032",
           "text": "🧰🛠 Esta é apenas uma das maneiras pelas quais a inovação dos desenvolvedores ajuda a tornar o Twitter um lugar melhor. Você pode encontrar outras ferramentas prontas para uso desenvolvidas por nossa comunidade de desenvolvedores em nossa Caixa de Ferramentas do Twitter aqui ⬇️ https://t.co/rK0X30JSYU"
       },
       {
           "id": "1501257716941000709",
           "text": "📣Hoje é um dia importante! \nFirmamos parceria com @Jigsaw no lançamento desta nova ferramenta. Esta colaboração permite que ONGs e organizações sem fins lucrativos desenvolvam ferramentas que ajudem as pessoas a se manterem seguras no Twitter, atendendo às necessidades e preferências das comunidades que atendem. Saiba Mais ⬇️ https://t.co/MmznmgxoWT"
       },
       {
           "id": "1501686770810900485",
           "text": "Junte-se a nós amanhã para dar continuidade à conversa sobre personalização de timelines e como isso pode funcionar para desenvolvedores. E fiquem atentos para mais Spaces na próxima semana. 👀 https://t.co/P4JTc14mdC"
       },
       {
           "id": "1501596763194593285",
           "text": "A inovação dos desenvolvedores é sempre importante, inclusive em tempos de crise. Se você está desenvolvendo ferramentas para ajudar a conectar pessoas, mantê-las seguras ou compartilhar informações com o mundo, estamos aqui para apoiar—responda a este Tweet para nos contar mais sobre seu app."
       }
   ]
}
⌘I