Gerenciar Lists fixadas

Atenção: Este guia pressupõe que você concluiu os pré-requisitos na visão geral de Introdução rápida.

​

Etapas para criar uma solicitação para gerenciar List fixada

Primeira etapa: escolha a coleção de endpoints de List no Postman

Depois de carregar a coleção da X API v2 no Postman, navegue até a pasta “List”, selecione a pasta “Pinned Lists” e, em seguida, escolha “Pin a List”.  

Segunda etapa: especifique a List a ser fixada

Os endpoints de gerenciamento de List fixada exigem dois IDs: um para o usuário (o usuário autenticado que irá fixar uma List) e outro para a List de destino (a List a ser fixada). O ID do usuário deve corresponder ao ID do usuário autenticado, o que significa que você deve enviar os Access Tokens associados ao ID do usuário ao autenticar sua solicitação. Neste caso, você pode especificar o ID pertencente ao seu usuário. 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. Observando seu Access Token, você verá que a parte numérica é o seu ID de usuário.

O ID da List de destino pode ser qualquer List válida. No Postman, navegue até a aba “Params” e insira o ID do usuário na coluna “Value” da variável de caminho id. Navegue até a aba “Body” e informe o ID da List que você deseja fixar como valor do parâmetro list_id. Certifique-se de não incluir espaços antes ou depois de qualquer ID.

Key	Value	Parameter type
id	O ID do usuário	path
list_id	O ID da List de destino a ser fixada	body

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

      https://api.x.com/2/users/2244994945/pinned_lists

Etapa três: Faça sua requisição e revise a resposta

Quando tudo estiver configurado, clique no botão “Send” e você receberá uma resposta semelhante ao exemplo a seguir:

{
  "data": {
    "pinned": true
  }
}

Você fixou a List de destino com sucesso se o objeto de resposta retornado contiver o valor true para a chave pinned. 

Para desafixar uma List, selecione a solicitação “Unpin List”, também localizada na pasta “Lists” da coleção X API v2 carregada no Postman. Este endpoint requer o ID do usuário autenticado e o ID da List a ser desafixada. Na aba “Params”, insira o user ID como valor na coluna id e o ID da List a ser desafixada como valor na coluna list_id. 

Em uma solicitação DELETE bem-sucedida, você receberá uma resposta semelhante ao seguinte exemplo:

{
  "data": {
    "pinned": false
  }
}