O que é uma API?
A sigla API vem do inglês Application Programming Interface (Interface de Programação
de Aplicações). Pense nela como um "garçom" que atende ao seu pedido em um
restaurante.
Você (o cliente): Quer pedir um prato (buscar dados de um servidor).
O cardápio (a documentação da API): Mostra os pratos disponíveis e como pedi-los
(quais dados você pode acessar e como fazer a requisição).
O garçom (a API): Pega o seu pedido e leva para a cozinha (o servidor) e, em seguida,
traz o prato pronto (a resposta com os dados que você pediu).
Em termos técnicos, uma API é um conjunto de regras e protocolos que permite que
diferentes aplicações de software se comuniquem entre si. Elas definem os métodos e
formatos para que uma aplicação (o cliente) possa solicitar e receber dados de outra
aplicação (o servidor).
As APIs são o motor da internet moderna. Elas permitem que serviços distintos, como o
Google Maps e o Uber, troquem informações. Quando você solicita uma corrida no
Uber, o aplicativo usa a API do Google Maps para exibir a localização do motorista e a
rota, sem que o Uber precise criar seu próprio sistema de mapas.
Por que [Link]?
Existem diversas maneiras de construir uma API, mas o [Link] se destaca por ser
um framework web minimalista e flexível para [Link]. Ele simplifica a criação de
rotas, a manipulação de requisições e a organização do seu código.
Com o Express, você pode focar na lógica da sua API sem se preocupar com a
complexidade de lidar com as requisições HTTP do zero.
Criando uma API com [Link]
Passo 1: Configurar o projeto
Primeiro, crie uma nova pasta para o seu projeto e, no terminal, navegue até ela.
Em seguida, inicialize um novo projeto [Link]. O comando a seguir criará um arquivo
[Link] para gerenciar as dependências do seu projeto.
Agora, instale o [Link]
Passo 2: Criar o servidor básico
Crie um arquivo chamado [Link] (ou [Link]) na raiz do seu projeto. Este será o ponto
de entrada da sua aplicação.
Para rodar o servidor, volte ao terminal e execute:
Se tudo deu certo, você verá a mensagem Servidor rodando em [Link]
Agora, abra seu navegador e acesse esse endereço. Você verá a mensagem que
definimos na rota.
Passo 3: Adicionar uma rota com dados
Vamos adicionar uma nova rota que simula a busca por dados, como uma lista de
usuários. Para isso, vamos criar uma array de objetos.
Agora, salve o arquivo, reinicie o servidor (pressione Ctrl + C e depois node [Link]) e
acesse no seu navegador ou em um cliente HTTP, como o Insomnia ou o Postman, o
endereço [Link]
Você receberá uma resposta em JSON (JavaScript Object Notation), que é o formato
padrão para a troca de dados em APIs REST.
Passo 4: Criar uma rota dinâmica para buscar um único usuário
E se quisermos buscar apenas um usuário específico pelo seu ID? O Express permite
criar rotas dinâmicas usando parâmetros.
Agora, reinicie o servidor e acesse [Link] Você verá os
dados do Pedro Santos. Se tentar um ID que não existe, como
[Link] receberá a mensagem de erro que configuramos.
Conclusão
Uma API é a espinha dorsal de qualquer ecossistema de software conectado,
permitindo que aplicações conversem entre si. Com o [Link], o processo de
construção de uma API se torna muito mais simples e intuitivo.
Fontes
Documentação [Link]: [Link]
MDN Web Docs: [Link]
FreeCodeCamp: [Link]
Artigo "What is an API?" da Red Hat: [Link]
an-api