Guia de início rápido

​

Introdução aos endpoints de consulta de Posts

Este guia de introdução rápida ajudará você a fazer sua primeira solicitação aos endpoints de consulta de Posts, especificando um conjunto de fields, usando o Postman.

Se você quiser ver exemplos de código em diferentes linguagens, visite nosso repositório no GitHub: X API v2 sample code.

​

Pré-requisitos

Para concluir este guia, você precisará de um conjunto de chaves e tokens para autenticar sua solicitação. Você pode gerar essas chaves e tokens seguindo estas etapas:

• Cadastre-se para uma conta de desenvolvedor e obtenha aprovação.
• Crie um Projeto e um App de desenvolvedor associado no portal do desenvolvedor.
• Acesse a página “Keys and tokens” do seu App para gerar as credenciais necessárias. Certifique-se de salvar todas as credenciais em um local seguro.

​

Etapas para construir uma solicitação GET /tweets

​

Etapa 1: comece com uma ferramenta ou biblioteca

Há várias ferramentas, exemplos de código e bibliotecas que você pode usar para fazer uma solicitação a este endpoint, mas aqui usaremos o Postman para simplificar o processo.

Para carregar a coleção do X API v2 do Postman no seu ambiente, clique no botão abaixo:

Adicionar X API v2 ao Postman

Depois que a coleção do X API v2 estiver carregada no Postman, navegue até a solicitação “Post Lookup > Multiple Posts”.

​

Segundo passo: Autentique sua solicitação

Para fazer uma solicitação corretamente à X API, é necessário verificar se você tem permissão. Você pode autenticar sua solicitação com:

• OAuth 2.0 App-Only
• OAuth 2.0 Authorization Code com PKCE
• Contexto de Usuário do OAuth 1.0a

Para simplificar, vamos utilizar OAuth 2.0 App-Only nesta solicitação; porém, se você quiser acessar metrics privadas ou Posts, será necessário usar um dos outros métodos de autenticação.

Para utilizar OAuth 2.0 App-Only, você deve adicionar suas chaves e tokens (especificamente o App Access Token, também conhecido como App-only Bearer Token) ao Postman selecionando o ambiente chamado “X API v2” (no canto superior direito do Postman) e adicionando suas chaves e tokens aos campos “initial value” e “current value” (clicando no ícone de olho ao lado do menu suspenso de ambientes).

Se você fez tudo corretamente, essas variáveis serão preenchidas automaticamente na aba de autorização da solicitação.

​

Etapa três: Identifique e especifique quais Posts você deseja recuperar

Você deve especificar um Post ou um conjunto de Posts que deseja receber na solicitação. Você pode encontrar o ID do Post navegando em X.com, clicando em um Post e então verificando a URL. Por exemplo, o ID do Post do seguinte URL é 1228393702244134912.

https://x.com/TwitterDev/status/1228393702244134912

No Postman, vá até a guia “Params” e insira esse ID, ou uma sequência de IDs de Post separados por vírgula, na coluna “Value” do parâmetro ids.

Key	Value
ids	1228393702244134912,1227640996038684673,1199786642791452673

---

​

Etapa quatro: identifique e especifique quais fields você deseja recuperar

Se você clicar no botão “Send” após a etapa três, receberá os campos do Objeto Post padrão na sua resposta: id, text e edit_history_tweet_ids.

Para este exercício, solicitaremos três conjuntos adicionais e distintos de fields de objetos diferentes:

• O tweet.created_at adicional nos objetos Post primários.
• Os fields padrão do objeto de usuário dos autores associados para os Posts retornados: id, name e username
• O user.created_at adicional nos objetos de usuário associados.

No Postman, navegue até a aba “Params” e adicione o seguinte par key:value à tabela “Query Params”:

Key	Value	Returned fields
tweet.fields	created_at	tweets.created_at
expansions	author_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

Você deve ver esta URL ao lado do botão “Send”:

https://api.x.com/2/tweets?ids=1228393702244134912,1227640996038684673,1199786642791452673&tweet.fields=created_at&expansions=author_id&user.fields=created_at

​

Etapa cinco: Faça sua solicitação e revise a resposta

Quando tudo estiver configurado, clique no botão “Send” e você receberá a seguinte resposta:

{
    "data": [
        {
            "edit_history_tweet_ids": [
                "1228393702244134912"
            ],
            "text": "O que o desenvolvedor escreveu no cartão de Dia dos Namorados?\n  \nwhile(true) {\n    I = Love(You);  \n}",
            "id": "1228393702244134912",
            "created_at": "2020-02-14T19:00:55.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1227640996038684673"
            ],
            "text": "Médicos: Pesquisar coisas no Google não te torna médico\n\nDesenvolvedores: https://t.co/mrju5ypPkb",
            "id": "1227640996038684673",
            "created_at": "2020-02-12T17:09:56.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1199786642791452673"
            ],
            "text": "C#",
            "id": "1199786642791452673",
            "created_at": "2019-11-27T20:26:41.000Z",
            "author_id": "2244994945"
        }
    ],
    "includes": {
        "users": [
            {
                "name": "Desenvolvedores",
                "created_at": "2013-12-14T04:35:55.000Z",
                "id": "2244994945",
                "username": "XDevelopers"
            }
        ]
    }
}