Skip to main content

​
Consulta de List: Standard v1.1 comparado com X API v2

Se você tem usado os endpoints standard v1.1 GET lists/show e GET lists/ownerships, o objetivo deste guia é ajudar você a entender as semelhanças e diferenças entre os endpoints de consulta de List do standard v1.1 e da X API v2.
  • Semelhanças
    • Métodos de autenticação
    • Rate limits
  • Diferenças
    • URLs dos endpoints
    • Requisitos de App e Project
    • Limites de objetos de dados por requisição
    • Formatos dos dados de resposta
    • Parâmetros da requisição

​
Semelhanças

Autenticação Ambas as versões de endpoint suportam tanto OAuth 1.0a User Context quanto App only. Portanto, se você estava usando um dos endpoints de consulta de List do standard v1.1, pode continuar usando o mesmo método de autenticação ao migrar para a versão X API v2. Dependendo da sua biblioteca/pacote de autenticação, a autenticação App only provavelmente é a maneira mais fácil de começar e pode ser configurada com um simples cabeçalho de requisição. Para saber como gerar um Access Token App only, consulte este guia sobre App only. Rate limits

​
Diferenças

URLs dos endpoints Requisitos de App e Project Os endpoints da X API v2 exigem que você use credenciais de um App de desenvolvedor que esteja associado a um Project ao autenticar suas requisições. Todos os endpoints da X API v1.1 podem usar credenciais de Apps ou de Apps associados a um Project. Limites de objetos de dados por requisição O endpoint standard v1.1 /lists/ownerships permite retornar até 1000 Lists por requisição. Os novos endpoints v2 permitem retornar até 100 Lists por requisição. Por padrão, 100 objetos de usuário serão retornados; para alterar o número de resultados, você precisará passar um parâmetro de consulta max_results= com um número entre 1-100; em seguida, pode passar o next_token retornado no payload da resposta para o parâmetro pagination_token na próxima requisição. Formato dos dados de resposta Uma das maiores diferenças entre as versões dos endpoints standard v1.1 e X API v2 é como você seleciona quais fields são retornados no seu payload. Nos endpoints standard, você recebe muitos dos fields de resposta por padrão e depois tem a opção de usar parâmetros para identificar quais fields ou conjuntos de fields adicionais devem retornar no payload. A versão X API v2 entrega, por padrão, apenas os fields id e name da List. Para solicitar qualquer field ou objeto adicional, você precisará usar os parâmetros fields e expansions. Quaisquer fields de List que você solicitar deste endpoint retornarão no objeto principal de List. Qualquer objeto Post ou user expandido e seus fields retornarão em um objeto includes dentro da sua resposta. Você pode então relacionar quaisquer objetos expandidos ao objeto de List combinando os IDs presentes tanto no objeto de usuário quanto no objeto Post expandido. A seguir estão exemplos de possíveis List fields e expansions:
  • created_at
  • follower_count
  • member_count
  • owner_id
  • description
  • private
Recomendamos que você leia mais sobre esses novos parâmetros em seus respectivos guias, ou consultando nosso guia sobre como usar fields e expansions. Também elaboramos um guia de migração do formato de dados que pode ajudar a mapear fields do standard v1.1 para os fields mais recentes da v2. Esse guia também informará qual parâmetro específico de expansion e field você precisará passar com sua requisição v2 para retornar certos fields. Além das mudanças na forma como você solicita determinados fields, a X API v2 também está introduzindo novos designs JSON para os objetos retornados pelas APIs, incluindo os objetos Post e user.
  • No nível raiz do JSON, os endpoints standard retornam objetos Post em um array statuses, enquanto a X API v2 retorna um array data.
  • Em vez de se referir a “statuses” Retweeted e Quoted, o JSON da X API v2 refere-se a Retweeted e Quoted Tweets. Muitos fields legados e obsoletos, como contributors e user.translator_type, estão sendo removidos.
  • Em vez de usar tanto favorites (no objeto Post) quanto favourites (no objeto user), a X API v2 usa o termo like.
  • A X está adotando a convenção de que valores JSON sem valor (por exemplo, null) não são incluídos no payload. Atributos de Post e user só são incluídos quando têm valores não nulos.
Parâmetros da requisição Os seguintes parâmetros de requisição do standard v1.1 têm equivalentes na X API v2: Consulta de List por ID Consulta de Lists de propriedade de um usuário