Visão geral

Comparando os endpoints de Posts lookup da X API

Os endpoints de Posts lookup da v2 substituem os endpoints standard v1.1 GET statuses/lookup e GET statuses/show. Este guia é para desenvolvedores que estão migrando dessas versões mais antigas para a X API v2.

Tabela de comparação de endpoints

Descrição	Standard v1.1	X API v2
Métodos HTTP suportados	`GET`	`GET`
Domínio do host	`https://api.x.com`	`https://api.x.com`
Caminho do endpoint	`/1.1/statuses/show.json`, `/1.1/statuses/lookup.json`	`/2/tweets`
Autenticação	OAuth 1.0a User Context	OAuth 1.0a User Context, OAuth 2.0 App-Only, OAuth 2.0 Authorization Code com PKCE
Formato JSON do Post	Formato Standard v1.1	Formato X API v2, determinado pelos parâmetros `fields` e `expansions` (não compatível com versões anteriores do v1.1)
Suporta seleção de fields específicos		✔
Suporta os fields de annotations		✔
Suporta novos fields de metrics		✔
Suporta o field `conversation_id`		✔
Fornece histórico de edições de Post	✔	✔
Requer credenciais de um App de desenvolvedor associado a um Project		✔

Standard v1.1 em comparação com a X API v2

Se você tem trabalhado com o standard v1.1 GET statuses/show e GET statuses/lookup, este guia ajudará você a entender as similaridades e diferenças entre os endpoints de Posts lookup do standard e da X API v2. Você também pode se interessar pela nossa ferramenta visual de migração de formato de dados para ajudar a ver rapidamente as diferenças entre o formato de dados da X API v1.1 e o formato da X API v2.

Similaridades
- OAuth 1.0a User Context
- Limites de Posts por requisição
- Suporte para histórico de edições e metadados de Post
Diferenças
- URLs dos endpoints
- Requisitos de App e Project
- Formato dos dados de resposta
- Parâmetros de requisição

Similaridades

Método de autenticação OAuth 1.0a User Context

O endpoint standard suporta OAuth 1.0a User Context, enquanto o novo endpoint de Post lookup da X API v2 suporta tanto OAuth 1.0a User Context quanto OAuth 2.0 App-Only. Portanto, se você estava anteriormente usando um dos endpoints standard v1.1 de Post lookup, você pode continuar usando o mesmo método de autenticação se migrar para a versão X API v2. A autenticação App-Only provavelmente é a maneira mais fácil de começar. Para saber como gerar um App Access Token, consulte este guia de OAuth 2.0 App-only.

Limites de Posts por requisição

O endpoint v1.1 GET statuses/lookup permite especificar até 100 Posts por requisição. Isso também se aplica ao endpoint GET /tweets. Para especificar 100 Posts completos, use o parâmetro ids como um query parameter com uma lista separada por vírgulas de IDs de Post. Suporte para histórico de edições e metadados de Post Ambas as versões fornecem metadados que descrevem qualquer histórico de edições. Confira as Referências da API de Post lookup e a página de fundamentos de edição de Posts para mais detalhes.

Diferenças

URLs dos endpoints

Endpoints standard v1.1:
- https://api.x.com/1.1/statuses/show
- https://api.x.com/1.1/statuses/lookup
Endpoint da X API v2:
- https://api.x.com/2/tweets
- https://api.x.com/2/tweets/:id

Requisitos de App e Project

Os endpoints da X API v2 exigem credenciais de um App de desenvolvedor associado a um Project para autenticação. Os endpoints da X API v1.1 podem usar credenciais de Apps ou Apps associados a um App.

Formato dos dados de resposta

Uma diferença significativa entre as versões dos endpoints standard v1.1 e X API v2 é como os fields são selecionados no payload. Para endpoints standard, muitos fields de resposta são incluídos por padrão, com opções de usar parâmetros para especificar fields adicionais. A X API v2, no entanto, entrega apenas os fields id e text do Post por padrão. Fields e objetos adicionais exigem o uso dos parâmetros fields e expansions. Os fields expandidos retornam em um objeto includes dentro da resposta, que pode ser associado ao objeto Post primário fazendo a correspondência dos IDs. Para mais informações sobre como usar fields e expansions, consulte o guia sobre como usar fields e expansions. Um guia de migração de formato de dados também mapeia os fields do standard v1.1 para os fields mais novos da v2. Além disso, a X API v2 introduz novos designs JSON para objetos, incluindo os objetos Post e user:

Endpoints standard retornam objetos Post em um array statuses, enquanto a X API v2 usa um array data.
Retweeted e Quoted Tweets na X API v2 substituem a terminologia “statuses”.
Nova terminologia como like substitui termos como favorites e favourites.
Atributos sem valores (ex.: null) não são incluídos nos payloads da X API v2.

O objeto Post na X API v2 inclui novos fields como:

conversation_id
Dois novos fields de annotations (context e entities)
Novos fields de metrics
Field reply_setting mostrando quem pode responder a um determinado Post

Parâmetros de requisição

Os seguintes parâmetros de requisição do standard v1.1 têm equivalentes na X API v2:

Standard	X API v2
`id`	`ids`

Certos parâmetros do standard v1.1 não são suportados na X API v2:

Standard	Comentário
`tweet_mode`	Substituído pela funcionalidade de fields e expansions.
`trim_user`	Substituído por fields e expansions. Use a expansion `author_id` e `user.fields` para dados de usuário.
`include_my_retweet`	Fornece o ID do Post de origem para Posts Retweetados pelo usuário autenticador.
`include_entities`	Use fields e expansions para controlar entities no payload.
`include_ext_alt_text`	Adiciona o field `ext_alt_text` na entity de mídia se o texto alternativo estiver presente.
`include_card_uri`	Adiciona `card_uri` quando um ads card estiver anexado.
`map`	Retorna o Post ID e a mensagem de erro para Posts indisponíveis na X API v2, ao contrário dos fields anulados na v1.1.

Requisições cURL

As requisições cURL a seguir mostram endpoints do standard v1.1 e seus equivalentes na v2. Substitua ACCESS_TOKEN no header pelo access token do seu app. Para endpoints v2, o token deve pertencer a um App de desenvolvedor dentro de um Project. Os payloads de resposta da v1.1 diferem dos da v2. Com a v2, você pode solicitar fields diferentes com os parâmetros fields e expansions. Endpoints standard v1.1 GET statuses/lookup e v2 GET /tweets

curl --request GET \
  --url 'https://api.x.com/1.1/statuses/lookup.json?id=1460323737035677698%2C1460323743339741184' \
  --header 'Authorization: Bearer $ACCESS_TOKEN'

curl --request GET \
  --url 'https://api.x.com/2/tweets?ids=1460323737035677698%2C1460323743339741184&tweet.fields=created_at&expansions=author_id&user.fields=created_at' \
  --header 'Authorization: Bearer $ACCESS_TOKEN'

Endpoints standard v1.1 GET statuses/show/:id e v2 GET /tweets/:id

curl --request GET \
  --url 'https://api.x.com/1.1/statuses/show.json?id=1460323737035677698' \
  --header 'Authorization: Bearer $ACCESS_TOKEN'

curl --request GET \
  --url 'https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at&expansions=author_id&user.fields=created_at' \
  --header 'Authorization: Bearer $ACCESS_TOKEN'

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Visão geral

Comparando os endpoints de Posts lookup da X API

Tabela de comparação de endpoints

Standard v1.1 em comparação com a X API v2

Similaridades

Método de autenticação OAuth 1.0a User Context

Limites de Posts por requisição

Diferenças

URLs dos endpoints

Requisitos de App e Project

Formato dos dados de resposta

Parâmetros de requisição

Requisições cURL

​Comparando os endpoints de Posts lookup da X API

​Tabela de comparação de endpoints

​Standard v1.1 em comparação com a X API v2

​Similaridades

​Método de autenticação OAuth 1.0a User Context

​Limites de Posts por requisição

​Diferenças

​URLs dos endpoints

​Requisitos de App e Project

​Formato dos dados de resposta

​Parâmetros de requisição

​Requisições cURL

Comparando os endpoints de Posts lookup da X API

Tabela de comparação de endpoints

Standard v1.1 em comparação com a X API v2

Similaridades

Método de autenticação OAuth 1.0a User Context

Limites de Posts por requisição

Diferenças

URLs dos endpoints

Requisitos de App e Project

Formato dos dados de resposta

Parâmetros de requisição

Requisições cURL