Skip to main content

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

Se você vem trabalhando com os endpoints do Standard v1.1 GET blocks/ids e GET blocks/list, o objetivo deste guia é ajudar você a entender as semelhanças e diferenças entre os endpoints de consulta de bloqueios do Standard v1.1 e da X API v2.
  • Semelhanças
    • Autenticação
  • Diferenças
    • URLs de endpoint
    • Limites de usuários por requisição
    • Requisitos de App e Projeto
    • Formatos de dados de resposta
    • Parâmetros de requisição

​
Semelhanças

Autenticação Tanto os endpoints de consulta de bloqueios do Standard v1.1 quanto os do X API v2 usam o Contexto de Usuário do OAuth 1.0a. Portanto, se você já usava um dos endpoints de consulta de bloqueios do Standard v1.1, pode continuar usando o mesmo método de autenticação ao migrar para o X API v2. 

​
Diferenças

URLs de endpoint Limites de usuários por solicitação Os endpoints do Standard v1.1 permitem retornar até 5000 usuários por solicitação. Os novos endpoints v2 permitem retornar até 1000 usuários por solicitação. Para retornar os 1000 usuários completos, você precisará passar max_results=1000 como parâmetro query; em seguida, poderá passar o next_token retornado no payload da resposta para o parâmetro query pagination_token na sua próxima solicitação.   Requisitos de App e Projeto Os endpoints do X API v2 exigem que você use credenciais de um App de desenvolvedor associado a um Projeto ao autenticar suas solicitações. Todos os endpoints do X API v1.1 podem usar credenciais de Apps independentes ou Apps associados a um projeto. Formato de dados da resposta Uma das maiores diferenças entre as versões de endpoint do Standard v1.1 e do X API v2 é como você seleciona quais fields retornam no seu payload. Nos endpoints Standard, muitos fields da resposta são retornados por padrão, e você pode usar parâmetros para indicar quais fields ou conjuntos de fields devem retornar no payload. No X API v2, apenas os fields user id, name e username são retornados por padrão. Para solicitar fields ou objetos adicionais, você precisará usar os parâmetros fields e expansions. Quaisquer user fields solicitados neste endpoint retornarão no objeto de usuário principal. Qualquer Objeto Post expandido e seus fields retornarão em um objeto includes dentro da sua resposta. Você pode correlacionar os objetos expandidos ao objeto de usuário correspondendo os IDs presentes tanto no usuário quanto no Objeto Post expandido.  Incentivamos você a ler mais sobre esses novos parâmetros em seus respectivos guias ou consultando nosso guia sobre como usar fields e expansions.  Também preparamos um guia de migração de formato de dados que pode ajudar você a mapear os fields do Standard v1.1 para os novos fields da v2. Esse guia também fornecerá o parâmetro específico de expansion e field que você precisará passar com sua solicitação v2 para retornar fields específicos.    Além das mudanças em como você solicita determinados fields, o X API v2 também está introduzindo novos designs 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 Post 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 obsoletos, 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 de usuário só são incluídos se tiverem valores não nulos.   
Também introduzimos um novo conjunto de fields no Objeto Post, incluindo o seguinte:
  • Um field conversation_id
  • Dois novos fields de annotations, incluindo context e entities
  • Vários novos fields de metrics 
  • Um novo field reply_setting, que mostra quem pode responder a um determinado Post
Parâmetros de solicitação Os seguintes parâmetros de solicitação do Standard v1.1 aceitavam dois parâmetros de query (user_id ou screen_name). A X API v2 aceita apenas o id de usuário numérico, que deve ser passado como parte do caminho do endpoint.
⌘I