Introdução (3 min)

Imagine que você precisa enviar uma carta. Você pode ir até os correios, preencher um formulário, pagar o envio e esperar a entrega. Ou, pode usar um serviço de entrega online, preenchendo um formulário em um site e agendando a coleta. O cURL é como esse serviço online para APIs, permitindo que você “envie cartas” (requisições) e receba “respostas” diretamente da linha de comando.

Dominar o cURL é vital no desenvolvimento moderno de APIs. Ele possibilita testar, depurar e interagir com seus serviços de forma rápida e eficiente, sem precisar de interfaces gráficas complexas.

Nesta aula, você aplicará o cURL para fazer requisições a APIs, explorando seus principais recursos e entendendo seu contexto dentro do ecossistema Node.js/Express.

Conceito Fundamental (7 min)

cURL (Client URL) é uma ferramenta de linha de comando que permite transferir dados usando diversos protocolos, incluindo HTTP. Ele é usado para enviar requisições a servidores web e receber respostas, simulando a interação de um navegador ou de um cliente de API.

Na indústria, o cURL é frequentemente usado para testes de integração, monitoramento de APIs e automação de tarefas. Imagine, por exemplo, um sistema que precisa verificar periodicamente o status de um servidor. Um script com cURL pode realizar essa tarefa de forma eficiente.

O cURL se integra com diversas outras tecnologias, como scripts Bash, Python e Node.js. Suas vantagens incluem a portabilidade (funciona em vários sistemas operacionais), a flexibilidade (suporta inúmeros protocolos e opções) e a facilidade de uso. A principal desvantagem é a necessidade de se familiarizar com a sintaxe da linha de comando.

Implementação Prática (10 min)

Vamos construir um exemplo prático. Assuma que você tem uma API Node.js/Express rodando no seu HostGator Plano M, ouvindo na porta 3000, com uma rota /mensagem que retorna uma mensagem simples:

// server.js
const express = require('express');
const app = express();
const port = 3000;

app.get('/mensagem', (req, res) => {
  res.send('Olá do servidor!');
});
app.listen(port, () => {
  console.log(Servidor ouvindo na porta ${port});
});

Agora, vamos usar o cURL para fazer uma requisição GET a essa rota:

curl http://localhost:3000/mensagem

Este comando envia uma requisição GET para http://localhost:3000/mensagem. A resposta do servidor (“Olá do servidor!”) será exibida diretamente no terminal.

Podemos adicionar opções ao cURL para customizar a requisição. Por exemplo, para visualizar os cabeçalhos da resposta:

curl -i http://localhost:3000/mensagem

Para enviar dados em uma requisição POST (assumindo que o servidor está configurado para receber dados JSON):

curl -X POST -H "Content-Type: application/json" -d '{"nome": "João"}' http://localhost:3000/mensagem

Neste exemplo, -X POST especifica o método POST, -H define o cabeçalho Content-Type e -d envia os dados no corpo da requisição.

Exercício Hands-On (5 min)

Desafio: Modifique o código do servidor para que a rota /mensagem aceite um parâmetro de consulta chamado nome e retorne “Olá, [nome]!”. Em seguida, utilize o cURL para enviar uma requisição GET com o parâmetro nome definido como seu nome.

Solução:

// server.js (modificado)
app.get('/mensagem', (req, res) => {
  const nome = req.query.nome;
  res.send(Olá, ${nome}!);
});

curl http://localhost:3000/mensagem?nome=SeuNome

Para testar, execute o servidor Node.js e, em seguida, execute o comando cURL. A resposta deverá ser “Olá, SeuNome!”.

Troubleshooting: Se houver erros, verifique se o servidor está rodando corretamente e se a URL e os parâmetros estão corretos no comando cURL.

Próximos passos: Explore outras opções do cURL, como autenticação, manipulação de cookies e upload de arquivos.