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?
? O que você precisa para esse tutorial?
- Visual Studio
- Conta no Twitter (cola aqui se você ainda não tiver)
? E como vai funcionar?
Antes de mais nada, vamos alinhar uma coisinha: esse tutorial vai ser dividido em três partes.
- ?? 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)
- 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)
- 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!
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).
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.
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.
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:
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).
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
- Parte dois publicada! – em 23/08/2020
- Parte três publicada! – em 11/09/2020
- Publiquei o projeto final em um repositório no meu GitHub! – em 13/09/2020
? 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! ?