Introdução (3 min)

Imagine a internet como um sistema postal gigantesco. Para enviar uma carta (informação), precisamos de um endereço (URL) e um carteiro (protocolo) que saiba como entregar a mensagem. Entender como esse sistema funciona é absolutamente primordial para o desenvolvimento de APIs modernas, pois elas são a base da comunicação entre sistemas na web.

Nesta aula, você vai aprender os fundamentos da internet e os protocolos que a governam, com foco no HTTP, o protocolo central para a web. Este conhecimento é essencial dentro do ecossistema Node.js/Express, pois permite construir aplicações web robustas e eficientes que se comunicam efetivamente com o mundo exterior.

Conceito Fundamental (7 min)

Protocolos são conjuntos de regras que ditam como os computadores se comunicam na internet. Eles definem a sintaxe e a semântica das mensagens trocadas, garantindo que as informações sejam transmitidas e interpretadas corretamente. O HTTP (HyperText Transfer Protocol) é o protocolo dominante na web, usado para transferir dados entre um cliente (navegador) e um servidor.

Casos de uso reais em produção incluem navegação web, download de arquivos, streaming de vídeo e, crucialmente, comunicação com APIs. O HTTP se integra com outras tecnologias, como HTML, CSS e JavaScript para criar a experiência completa da web. Uma grande vantagem do HTTP é sua simplicidade e ubiquidade. Porém, uma possível desvantagem é sua natureza stateless, ou seja, cada requisição é independente das anteriores.

Implementação Prática (10 min)

Vamos criar um servidor web básico em Node.js com Express que responde a uma requisição HTTP:

// Importa o módulo Express
const express = require('express');
// Cria uma instância do aplicativo Express
const app = express();
// Porta onde o servidor irá escutar (compatível com HostGator Plano M)
const port = process.env.PORT || 3000;

// Rota que responde a requisições GET para a raiz ('/')
app.get('/', (req, res) => {
  // Log da requisição no console (prática profissional)
  console.log('Requisição recebida na raiz');
  // Envia uma resposta em formato texto
  res.send('Olá, mundo!');
});
// Inicia o servidor e escuta na porta especificada
app.listen(port, () => {
  console.log(Servidor rodando em http://localhost:${port});
});

Para executar este código:

npm install express
node seu_arquivo.js

Este código demonstra um servidor simples que escuta na porta 3000 (ou na porta definida pela variável de ambiente PORT, importante para HostGator Plano M) e responde com “Olá, mundo!” quando acessado via navegador. Note os comentários detalhados e a estrutura clara do código, seguindo as melhores práticas enterprise.

Exercício Hands-On (5 min)

Modifique o código acima para responder com “Bem-vindo à minha API!” na rota /api. Teste acessando http://localhost:3000/api no seu navegador.

Solução:

app.get('/api', (req, res) => {
  console.log('Requisição recebida em /api');
  res.send('Bem-vindo à minha API!');
});

Para testar, reinicie o servidor e acesse a nova rota. Se encontrar erros, verifique se o servidor está rodando corretamente e se a rota foi adicionada corretamente.

Próximos passos: explorar outros métodos HTTP (POST, PUT, DELETE) e aprender a lidar com dados de requisição.