Olá, estudante! Agora que você já aprendeu sobre back-end e seus ambientes, e, onde codificar através das IDEs, neste momento, vou lhe mostrar a importância das APIs (Application Programming Interface) ou um português ‘Interface de Programação de Aplicativos’. Elas (APIs) desempenham um papel fundamental no desenvolvimento de aplicativos em back-end, pois funcionam como pontes de comunicação, permitindo que diferentes sistemas interajam de forma eficiente e segura. Ao disponibilizar um conjunto de endpoint (endereços de URI – Uniform Resource Identifiers – em que cada um tem um objetivo único) e métodos padronizados, as APIs facilitam a troca de dados e funcionalidades entre aplicativos.

Falando especificamente de back-end, as APIs fornecem uma camada de abstração que permite aos técnicos em desenvolvimento de sistemas acessar recursos e serviços específicos do servidor sem precisar conhecer sua complexidade interna. Essa separação entre a interface e a implementação subjacente é o que torna as APIs tão poderosas e flexíveis. Além disso, as APIs oferecem a possibilidade de escalabilidade e expansão, permitindo que novos recursos sejam adicionados ao back-end sem afetar os clientes que consomem a API. Isso promove a modularidade do sistema e simplifica a manutenção e o desenvolvimento contínuo.

O que achou dessa prévia sobre todo o conteúdo que irei lhe apresentar ao longo desta lição? Nosso objetivo aqui é demonstrar que as APIs desempenham um papel central em qualquer arquitetura de back-end moderna. Elas colaboraram para que os profissionais técnicos em desenvolvimento de sistema possam criar aplicativos mais robustos, interconectados e escaláveis, facilitando a vida tanto dos desenvolvedores quanto dos usuários finais. 

Imagine que você, um(a) técnico(a) em desenvolvimento de sistemas esteja trabalhando em uma empresa que fornece um serviço de armazenamento em nuvem. Seu objetivo é criar um aplicativo para dispositivos móveis que permita aos usuários acessar, fazer upload e baixar arquivos armazenados na nuvem. No entanto, durante este trabalho você se depara com um desafio: como garantir que o aplicativo possa se comunicar de forma segura e eficiente com o servidor de armazenamento em nuvem, sem expor a lógica interna e a infraestrutura do servidor?

Aqui é onde as APIs com ênfase em back-end entram em jogo. A empresa de armazenamento em nuvem pode disponibilizar uma API bem projetada e documentada que atua como uma ‘Interface de Programação de Aplicativos’. Ela define um conjunto de endpoints (URIs) e métodos (GET, POST, PUT e DELETE) que permitem que o aplicativo móvel se conecte e interaja com o servidor. Por exemplo, o aplicativo pode usar um endpoint específico para autenticar o usuário e obter um token de acesso, que será usado em todas as solicitações subsequentes para verificar a identidade do usuário.

Através da API, o aplicativo móvel pode oferecer uma experiência de usuário perfeita, sem a necessidade de conhecer a complexidade interna do servidor de armazenamento em nuvem. Além disso, a empresa de armazenamento em nuvem pode atualizar e aprimorar o servidor sem afetar a funcionalidade do aplicativo, desde que a API permaneça consistente. Desta forma, podemos compreender que as APIs com ênfase em back-end resolvem o problema de comunicação segura e eficiente entre aplicativos e servidores, permitindo que desenvolvedores construam aplicativos mais poderosos e interconectados, e protegem a infraestrutura e a lógica interna do servidor.

Na lição de hoje, irei apresentar um case fictício sobre a empresa Tech Sales que atua no setor de tecnologia e oferece uma plataforma de gerenciamento de vendas para pequenas e médias empresas. A plataforma auxilia os clientes a acompanhar suas vendas, estoques e relatórios de desempenho em tempo real, proporcionando uma visão abrangente de seus negócios.

O grande desafio enfrentado pela Tech Sales era de fornecer uma experiência unificada e eficiente aos seus clientes, integrando-se com diversos sistemas de pontos de vendas (PDVs) e marketplaces. Cada um desses ‘sisteminhas’ tinha sua própria estrutura de dados e formas de autenticação, tornando a integração complexa e demorada para cada novo cliente que se conectava à plataforma.

Para superar esse desafio, a equipe de desenvolvimento implementou uma API robusta e escalável com ênfase em back-end que serviria como uma interface de programação de aplicativos para facilitar a integração com os diversos sistemas de PDVs e marketplaces dos clientes.

Com endpoints bem definidos para sincronização de vendas, atualização de estoques e geração de relatórios, bem como uma autenticação por tokens e autorização granular, a Tech Sales experimentou um aumento significativo na eficiência e na satisfação do cliente. Os clientes agora podiam integrar suas lojas físicas e virtuais à plataforma de gerenciamento de vendas de forma rápida e segura. 

Neste exemplo apresentado, fica muito claro como as APIs realmente auxiliam os desenvolvedores, não é mesmo? Mas, o principal é compreender como utilizá-las, portanto, vamos lá?

Segundo MDN WEB DOCS (2023), as mais diferentes requisições podem ser utilizadas pelos métodos vistos acima, mas também algumas requisições menos comuns como OPTIONS ou TRACE.

Os endpoints são os URIs específicos que representam os recursos e as ações disponíveis na API. Eles são a interface pela qual os clientes acessam e interagem com os recursos do servidor. Por exemplo, em uma API para gerenciamento de produtos, alguns endpoints podem ser:

Os endpoints são mapeados para ações específicas no servidor e seguem uma convenção de nomenclatura que facilita a compreensão e a utilização da API pelos desenvolvedores.

Já a autorização está relacionada aos privilégios ou permissões que um usuário autenticado possui para acessar recursos específicos da API. Enquanto a autenticação verifica a identidade, a autorização controla o que um usuário autenticado pode fazer após o login. Existem diferentes níveis de autorização, como:

A seguir, temos dois exemplos. Na figura 1, temos um exemplo do formato JSON, e na figura 2, temos um exemplo do formato XML, vejamos:

Para que você tenha uma ideia sobre como é o consumo de uma API de forma simplificada, irei mostrar na lição de hoje como consumir uma API pública do Github, que nos permite acessar informações de repositórios, usuários, problemas, pull requests e muito mais. Como documentação ela tem um usuário clássico da empresa: o Octocat, que é a mascote da empresa, que combina um gato com tentáculos de polvo. 

Então vamos lá! Acesse a API do Github. Para isso, você pode simplesmente inserir a URL correta no navegador web de sua preferência. Por exemplo, para obter informações sobre o usuário “octocat”, basta acessar a seguinte URL: “https://api.github.com/users/octocat”.

Fazendo isso você está realizando uma requisição através do método GET, sendo assim, a API do Github responderá com os dados do usuário “octocat” no formato JSON. A resposta exibirá informações como o nome, nome de usuário, localização, quantidade de seguidores e repositórios entre outros dados.

Para essa nossa prática, não é necessário criar nenhum código ou script. Apenas com o uso do navegador web, você pode realizar uma requisição GET e obter dados fornecidos pela API do GitHub diretamente em formato JSON.