Skip to main content

​
Consulta de likes: Standard v1.1 em comparação com X API v2

Se você vem trabalhando com o endpoint Standard v1.1 GET favorites/list, o objetivo deste guia é ajudar você a entender as semelhanças e diferenças entre o Standard v1.1 e os endpoints de consulta de likes da X API v2. Com a v2, também introduzimos um novo endpoint de usuários que deram like, que permite obter informações sobre os usuários que curtiram um Post.
  • Semelhanças
    • Autenticação
    • Limites de requisições
  • Diferenças
    • URLs de endpoint
    • Limitações de requisição
    • Requisitos de App e Projeto
    • Parâmetros de requisição
    • Novo formato JSON

​
Semelhanças

Autenticação Tanto os endpoints de consulta de likes do Standard v1.1 quanto do X API v2 usam OAuth 1.0a User Context ou OAuth 2.0 Bearer Token. Portanto, se você utilizava anteriormente os endpoints GET favorites/list do Standard v1.1, pode continuar usando o mesmo método de autenticação ao migrar para o X API v2, se desejar.  Dependendo da biblioteca/pacote de autenticação que você escolher, a autenticação com Bearer Token provavelmente é a maneira mais fácil de começar e pode ser configurada com um cabeçalho de requisição simples. Para saber como gerar um Bearer Token, consulte este guia de OAuth 2.0 Bearer Token.    Limites de requisições O endpoint Standard v1.1 GET favorites/list tem um limite de 75 solicitações por 15 minutos por usuário. O endpoint correspondente de Posts curtidos no v2 também possui esse mesmo limite. No entanto, esse endpoint do v2 também possui um limite adicional de 75 solicitações por 15 minutos por App.

​
Diferenças

URLs de endpoints Limitações de solicitação O endpoint v2 liked Posts permite solicitar de 5 a 100 Posts por requisição, mas você pode obter todos os likes de um Post usando tokens de paginação. O endpoint v1.1 GET favorites/list também permite obter todos os likes de Posts, mas você pode obter de 20 a 200 Posts por requisição. Para o endpoint v2 liking users, o limite é de 100 liking users por Post.    Requisitos de App e Projeto Os endpoints do X API v2 exigem o uso de credenciais de um developer App associado a um Projeto ao autenticar suas requisições. Todos os endpoints do X API v1.1 podem usar credenciais de Apps independentes ou Apps associadas a um projeto. Parâmetros de solicitação Os endpoints do Standard v1.1 aceitavam dois parâmetros de query (user_id ou screen_name). O X API v2 aceita apenas o ID numérico do usuário, que deve ser passado como parte do caminho do endpoint. Uma das maiores diferenças entre as versões de endpoints do Standard v1.1 e do X API v2 é como você seleciona quais fields retornam no payload. Nos endpoints Standard, há vários parâmetros para indicar quais fields ou conjuntos de fields devem retornar no payload, enquanto a versão do X API v2 simplifica esses parâmetros em fields e expansions.    Novo formato JSON O X API v2 está introduzindo novos designs de JSON para os objetos retornados pelas APIs, incluindo objetos de Post e de user.
  • No nível raiz do JSON, os endpoints Standard retornam objetos de usuário em um array statuses, enquanto o X API v2 retorna um array data. 
  • Em vez de se referir a “statuses” Retweeted e Quoted, o JSON do X API v2 se refere a Tweets Retweeted e Quoted. Muitos fields legados e descontinuados, como contributors e user.translator_type, estão sendo removidos. 
  • Em vez de usar tanto favorites (no Objeto Post) quanto favourites (no objeto de usuário), o 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 escritos no payload. Atributos de Post e user só são incluídos se tiverem valores não nulos.  
Além das mudanças feitas no novo formato JSON, também introduzimos um novo conjunto de fields ao Objeto Post, incluindo:
⌘I