Twitter API e C#: um tutorial – parte 1

Quando eu decidi fazer o bot da Pepita, percebi que não seria possível pegar os stories dela no Instagram, como eu queria desde o começo. Além disso, a API do Instagram também não me parecia muito amigável, o que me fez desistir dela bem rápido. Em compensação, encontrei muito material sobre a API e os Apps do Twitter e percebi que ali as coisas pareciam fluir muito mais fácil. Decidi ir por esse caminho e me dei bem! Por isso, decidi trazer para vocês (e também documentar para um uso futuro hehe) como fazer uma aplicação simples com a API do Twitter e C#! #bembackendela🙆

Dois logos do Twitter "conversando" entre si

💻 O que você precisa para esse tutorial?

📝 E como vai funcionar?

Antes de mais nada, vamos alinhar uma coisinha: esse tutorial vai ser dividido em três partes.

  1. 👉🏼 Criação da app no Twitter, na parte destinada à desenvolvedores, e vamos perceber quais partes dela são importantes para nós no projeto (spoiler: as chaves)
  2. Criação e configuração do projeto no Visual Studio, da maneira que eu gosto, e criação da classe de autorização (que é quem vai te ligar de fato à API do Twitter)
  3. Construção do método de “pegar” tweets de um usuário e exibição em um console (desculpem amigos, se eu fosse fazer algo com mais firula, esse tutorial seria beeeeem mais longo 😅)

Caso surja alguma mudança na trajetória enquanto esse tutorial está nascendo, prometo atualizar a listinha acima nos próximos posts! ✌🏼

Abra o seu navegador favorito e vamos começar!

O personagem Doctor dizendo a frase "You want to update... twittter?"
“Você quer atualizar… o Twitter?”

Twitter for Developers

Caso você não conheça, o Twitter tem toda uma plataforma (com APIs, documentações, casos de uso, etc) para desenvolvedores, e é justamente aqui onde nossa jornada começa.

Para compartilhar informações no Twitter da forma mais ampla possível, também fornecemos a empresas, desenvolvedores e usuários acesso programático a dados do Twitter com as nossas APIs (interfaces de programação de aplicativo).

Central de ajuda do Twitter

No navegador da sua preferência, acesse o site developer.twitter.com. Não busquei se há essa plataforma em português, mas vou traduzir tudo o que eu mencionar para facilitar a vida de quem não fala o inglês.

Página inicial do Twitter for Developers
Página inicial do Twitter for Developers

Lá no canto superior esquerdo, há o botão de Sign In (Entrar). Clique nele e logue no Twitter com a sua conta. Essa rede social safada vai tentar te desvirtuar de continuar esse tutorial te levando até a sua Home, mas seja forte e volte para o site do Twitter for Developers. Novamente, no canto superior esquerdo, vá onde estiver escrito o seu nome e abra o menu que ele traz. Vá até a opção Apps.

Página inicial do Twitter for Developers, com o menu aberto, conforme explicado no parágrafo anterior

Se você já tem alguma App criada no Twitter, ela vai aparecer aqui. Caso esta seja a sua primeira, um dia ela vai aparecer aqui também! 😊 Aqui é onde você consegue consultar todos os aplicativos criados por você que se conectam ao Twitter.

Criando seu App

No canto superior direito, há o botão de Create an app (criar um app). Clique nele e um formulário vai ser aberto para você, onde você terá que responder algumas perguntas. Esses detalhes serão visíveis para os usuários do aplicativo e alguns são obrigatórios para gerar as chaves da API necessárias para você poder se autenticar nos produtos do Twitter for Developers.

As questões são várias e servem para diversas coisas diferentes. Nós vamos preencher apenas o que é obrigatório, que são as seguintes:

  • App name (nome do app): você precisa escolher um nome para o seu aplicativo, com até 32 caracteres.
  • Application description (descrição da applicação): é o local onde você vai descrever seu aplicativo. É o lugar ideal para contar para os usuários dessa app o que ele faz. Você tem entre 10 e 200 caracteres.
  • Website URL (URL do site): é a URL que vai ser usada como “fonte” do seu tweet, caso seja um app que poste tweets em uma conta.
  • Tell us how this app will be used (conte-nos como esse app vai ser usado): este campo é visível apenas para funcionários do Twitter. É aqui que você conta, da forma mais detalhada possível, como seu aplicativo vai ser usado para que eles possam entender. Aqui o mínimo são 100 caracteres.

Depois de todos esses campos devidamente preenchidos, é só clicar em Create (Criar). Eu não criei um App novo para esse tutorial, mas quando criei o da Pepita, tive aprovação automática. Creio que você também não terá problemas.

Keys e Tokens: nosso objetivo!

Depois da App ter sido devidamente criada, você vai chegar nessa tela aqui:

Print da tela de Apps do Twitter

O que precisamos daqui para a nossa aplicação? Das chaves de consumo. Clique em Details (Detalhes) e depois vá até o submenu Keys and Tokens (Chaves e Tokens).

Print da tela de Keys and Tokens do Twitter

Voilá! Chegamos no nosso objetivo! Aqui temos a API key e a API secret key que precisamos para ligar a nossa aplicação em C# ao Twitter. Lembre-se sempre: essa informação é muito sensível (por isso a minha está coberta), pois é através desse código que você (e qualquer outra pessoa) pode ter acesso à sua aplicação.

No próximo post, vou mostrar como utilizar essas chaves através do método de autorização. Ou seja: nossa aplicação vai se conectar ao Twitter e dizer: “aqui estão minhas chaves. Por favor, me conceda acesso”. E esse acesso vai acontecer! #magia✨


🔄 Atualizações


📜 Posts relacionados

Um novo projeto pessoal: o Hey, Pepita bot!


📩 Recadinhos da paróquia

1- Gostou do texto? Tem algo a adicionar? Alguma crítica construtiva? Feedbacks? Sugestões? Pedidos? Fique à vontade para me contatar via email (oli.pmatt@gmail.com), via Twitter (@oliviamattiazzo) ou pela caixa de comentários aqui embaixo! Vai ser um prazer conversar contigo! ✨

2- Se você está vendo essa mensagem, saiba que meu site migrou! #yay Agora todos os posts e conteúdos ficarão disponíveis no oliviamattiazzo.dev, que é um endereço que faz muito mais sentido para mim. O domínio .com.br segue ativo por enquanto, mas em breve vai abaixo. Desde já, obrigada por estar aqui e acompanhar o meu trabalho! 💕

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Esse site utiliza o Akismet para reduzir spam. Aprenda como seus dados de comentários são processados.