Guia de início rápido

​

Introdução ao endpoint de consulta de Posts de List

Este guia de introdução rápida ajudará você a fazer sua primeira solicitação ao endpoint de consulta de Posts de List usando o Postman.

Visite nosso repositório no GitHub X API v2 sample code se 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:

• Inscreva-se para uma conta de desenvolvedor e aguarde a aprovação.
• Crie um Projeto e um App de desenvolvedor associado no portal do desenvolvedor.
• Acesse a página “Keys and tokens” do seu App para gerar as credenciais necessárias. Certifique-se de salvar todas as credenciais em um local seguro.

​

Etapas para criar uma solicitação de busca de Posts da List

​

Etapa 1: comece com uma ferramenta ou biblioteca

Há várias ferramentas, exemplos de código e bibliotecas que você pode usar para fazer uma requisição a este endpoint, mas aqui vamos usar o Postman para simplificar o processo.

Para carregar a coleção X API v2 do Postman no seu ambiente, clique no botão a seguir:

Adicionar X API v2 ao Postman

Depois que a coleção X API v2 estiver carregada no Postman, navegue até a pasta “List”, selecione a pasta “List Posts” e, em seguida, escolha “List Posts lookup”.  

​

Etapa dois: Autentique sua solicitação

Para fazer uma solicitação corretamente à X API, você precisa verificar que tem permissão. Para fazer isso com este endpoint, você deve autenticar sua solicitação com um dos seguintes métodos: App only, OAuth 2.0 Authorization Code com PKCE ou Contexto de Usuário do OAuth 1.0a.

Para simplificar, vamos utilizar App only nesta solicitação, mas, se você quiser solicitar metrics ou Posts privados, precisará usar um dos outros métodos de autenticação.

Para utilizar App only, você deve adicionar suas chaves e tokens (especificamente o App only Access Token, também conhecido como App only Bearer Token) ao Postman, selecionando o ambiente chamado “X API v2” (no canto superior direito do Postman) e adicionando suas chaves e tokens aos campos “initial value” e “current value” (clicando no ícone de olho ao lado do menu suspenso de ambientes).

Se você fez isso corretamente, essas variáveis serão preenchidas automaticamente na guia de autorização da solicitação.  

​

Etapa três: identificar e especificar de qual List você deseja recuperar Posts

Você deve especificar uma List que deseja receber na solicitação. Você pode encontrar o id da List acessando x.com, clicando em uma List e, em seguida, conferindo a URL. Por exemplo, o id da List na seguinte URL é 84839422.

https://x.com/i/lists/84839422

O id de destino pode ser qualquer id de List válido. No Postman, vá até a guia “Params” e insira seu id na coluna “Value” da variável de caminho id. Certifique-se de não incluir espaços antes ou depois de qualquer id.

Key	Value
id	84839422 (o id da List)

​

Etapa quatro: identifique e especifique quais fields você deseja recuperar

Se você clicar no botão “Send” após a etapa três, receberá os fields padrão do Objeto Post na sua resposta: id e text.

Se você quiser receber fields adicionais, será necessário especificá-los na sua solicitação com os parâmetros tweet.fields e/ou expansions.

Para este exercício, solicitaremos três conjuntos adicionais de fields de diferentes objetos:

• O field adicional created_at no objeto Lists primário.

• O objeto de usuário completo usando o parâmetro expansions

• O field adicional user.created_at no objeto de usuário associado.

No Postman, navegue até a aba “Params” e adicione o seguinte par key:value à tabela “Query Params”:

Key	Value	Returned fields
tweet.fields	created_at	created_at
expansions	author_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

Agora você deve ver uma URL semelhante ao lado do botão “Send”:

https://api.x.com/2/lists/84839422/tweets?expansions=author_id&user.fields=created_at&max_results=1

​

Etapa 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": [
    {
      "author_id": "4172587277",
      "id": "1458172421115101189",
      "text": "A Alemanha registrou nesta semana um recorde de novos casos de Covid-19. Segundo o governo e especialistas em Saúde, pessoas não vacinadas são responsáveis pela situação \nhttps://t.co/4POyaPwMLu"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "MomentsBrasil",
        "name": "X Moments Brasil",
        "created_at": "2015-11-12T16:46:02.000Z",
        "id": "4172587277"
      }
    ]
  },
  "meta": {
    "result_count": 1,
    "next_token": "7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix"
  }
}

Atenção: A resposta deste endpoint oferecerá suporte à consulta dos 800 Posts mais recentes de uma determinada List