Pular para o conteúdo principal
Observação: Este guia pressupõe que você concluiu os pré-requisitos da visão geral de Introdução rápida.

​
Etapas para criar uma solicitação de busca de List fixada

Etapa um: escolha a coleção de endpoints de List no Postman Depois de carregar a coleção X API v2 no Postman, navegue até a pasta “List”, selecione a pasta “Pinned Lists” e, em seguida, escolha “User’s pinned Lists”.   Etapa dois: identificar e especificar o usuário Para recuperar a List fixada de um usuário, você deve especificar o ID de usuário dele na solicitação. O ID de usuário deve corresponder ao ID do usuário que está autenticando, o que significa que você deve enviar os Access Tokens associados a esse ID de usuário ao autenticar sua solicitação. Neste exemplo, você pode especificar o ID da sua própria conta. Você pode encontrar seu ID de duas maneiras:
  1. Usando o endpoint users lookup por nome de usuário, você pode informar um nome de usuário e receber o campo id.
  2. Verificando seu Access Token, você verá que a parte numérica é seu ID de usuário.
No Postman, navegue até a aba “Params” e insira esse ID de usuário na coluna “Value” do parâmetro id.
KeyValue
id2244994945 (ID de usuário)
Etapa três: identificar e especificar quais fields você deseja recuperar Se você clicar no botão “Send” após a etapa três, receberá os fields padrão do List object na sua resposta: id e name. Se quiser receber fields adicionais além de id e name, será necessário especificá-los na sua solicitação com os parâmetros fields e/ou expansions. Para este exercício, solicitaremos três conjuntos adicionais de fields de diferentes objetos:
  • O field adicional follower_count no objeto List principal.
  • O user object completo usando o parâmetro expansions.
  • O field adicional tweet.created_at no objeto de usuário associado.
No Postman, navegue até a aba “Params” e adicione o seguinte par chave:valor à tabela “Query Params”:
KeyValueReturned fields
list.fieldsfollower_countfollower_count
expansionsowner_idincludes.users.id, <br/>includes.users.name, <br/>includes.users.username
user.fieldscreated_atincludes.users.created_at
Agora você deve ver uma URL semelhante ao lado do botão “Send”: https://api.x.com/2/users/2244994945/pinned_lists?expansions=owner_id&list.fields=follower_count&user.fields=created_at Etapa quatro: faça sua solicitação e revise sua resposta Depois que tudo estiver configurado, clique no botão “Send” e você receberá uma resposta semelhante ao exemplo a seguir: 
{
  "data": [
    {
      "follower_count": 0,
      "id": "1454155907651158017",
      "name": "lista de teste",
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "TwitterDev",
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55.000Z",
        "name": "Twitter Dev"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}
⌘I