// server.js
// Um servidor Express básico para demonstrar Parâmetros de Rota

// 1. Importar o módulo Express, essencial para construir nossa API.
const express = require('express');
// 2. Inicializar uma nova aplicação Express.
const app = express();
// 3. Definir a porta na qual o servidor irá escutar.
//    Utilizamos process.env.PORT para compatibilidade com ambientes de hospedagem (como HostGator Plano M),
//    que frequentemente definem esta variável de ambiente. Se não definida, usamos a porta 3000 como padrão.
const PORT = process.env.PORT || 3000;
// 4. Middleware para parsear o corpo das requisições JSON.
//    Embora não seja estritamente necessário para route params, é uma prática enterprise comum.
app.use(express.json());
// 5. Middleware de log simples para cada requisição recebida.
//    Isso é valioso para depuração e monitoramento em produção.
app.use((req, res, next) => {
    console.log([${new Date().toISOString()}] Requisição recebida: ${req.method} ${req.originalUrl});
    next(); // Continua para a próxima função middleware ou manipulador de rota
});
// --- Rotas com Parâmetros de Rota ---
// Rota 1: Captura um ID numérico. Ex: GET /produtos/123
// A sintaxe ':id' declara 'id' como um parâmetro de rota.
app.get('/produtos/:id', (req, res) => {
    // 6. Acessar os parâmetros de rota através de req.params.
    //    req.params é um objeto onde as chaves são os nomes dos parâmetros definidos na rota.
    const produtoId = req.params.id;
    // 7. Validação de entrada: Verificar se o ID é um número válido.
    //    É uma boa prática garantir que os dados recebidos estejam no formato esperado.
    if (isNaN(produtoId) || parseInt(produtoId) <= 0) {
        // Se a validação falhar, enviamos uma resposta de erro 400 (Bad Request).
        console.warn([ERRO DE VALIDAÇÃO] ID de produto inválido recebido: ${produtoId});
        return res.status(400).json({ 
            mensagem: 'ID do produto deve ser um número inteiro positivo.',
            codigoErro: 'INVALID_PRODUCT_ID'
        });
    }
    // 8. Simulação de busca em um banco de dados ou fonte de dados externa.
    //    Na vida real, aqui você faria uma chamada assíncrona para o seu banco.
    try {
        const produtoEncontrado = {
            id: parseInt(produtoId), // Converte para número após validação
            nome: Produto Exemplo ${produtoId},
            descricao: Detalhes para o produto de ID ${produtoId}.,
            preco: (100 + parseInt(produtoId)  0.5).toFixed(2)
        };
        // 9. Simula um cenário onde o produto não é encontrado (ex: ID muito alto).
        if (parseInt(produtoId) > 1000) {
             console.log([PRODUTO NÃO ENCONTRADO] ID: ${produtoId});
             return res.status(404).json({ 
                mensagem: Produto com ID ${produtoId} não foi encontrado.,
                codigoErro: 'PRODUCT_NOT_FOUND' 
            });
        }
        // 10. Se tudo correr bem, envia o produto encontrado.
        console.log([SUCESSO] Produto ${produtoId} solicitado e encontrado.);
        res.status(200).json(produtoEncontrado);
    } catch (erro) {
        // 11. Tratamento de erros fantástico: Captura qualquer erro inesperado durante o processamento.
        //     Isso previne que a aplicação trave e oferece uma resposta útil.
        console.error([ERRO INTERNO] Falha ao buscar produto ${produtoId}:, erro);
        res.status(500).json({ 
            mensagem: 'Ocorreu um erro interno no servidor ao processar sua requisição.',
            codigoErro: 'INTERNAL_SERVER_ERROR' 
        });
    }
});
// Rota 2: Captura um slug textual. Ex: GET /artigos/como-aprender-apis
// A sintaxe ':slug' declara 'slug' como um parâmetro de rota textual.
app.get('/artigos/:slug', (req, res) => {
    const artigoSlug = req.params.slug;
    // 12. Validação para slug: Verificar se o slug não está vazio ou contém caracteres inválidos.
    //     Aqui, uma validação simples para demonstrar. Em produção, você usaria regex mais complexas.
    if (!artigoSlug || artigoSlug.trim() === '' || artigoSlug.length < 3) {
        console.warn([ERRO DE VALIDAÇÃO] Slug de artigo inválido: ${artigoSlug});
        return res.status(400).json({ 
            mensagem: 'Slug do artigo deve ter pelo menos 3 caracteres e não pode ser vazio.',
            codigoErro: 'INVALID_ARTICLE_SLUG' 
        });
    }
    try {
        // 13. Simulação de um artigo baseado no slug.
        const artigoEncontrado = {
            slug: artigoSlug,
            titulo: Como Aprender APIs: O Guia Definitivo (${artigoSlug}),
            autor: 'Prof. PHD',
            conteudo: Este é o conteúdo detalhado sobre ${artigoSlug}, um tópico relevante em desenvolvimento de software.
        };
        // 14. Simula que certos slugs não existem.
        if (artigoSlug.toLowerCase() === 'artigo-inexistente') {
            console.log([ARTIGO NÃO ENCONTRADO] Slug: ${artigoSlug});
            return res.status(404).json({ 
                mensagem: Artigo com slug '${artigoSlug}' não foi encontrado.,
                codigoErro: 'ARTICLE_NOT_FOUND' 
            });
        }
        console.log([SUCESSO] Artigo '${artigoSlug}' solicitado e encontrado.);
        res.status(200).json(artigoEncontrado);
    } catch (erro) {
        console.error([ERRO INTERNO] Falha ao buscar artigo ${artigoSlug}:, erro);
        res.status(500).json({ 
            mensagem: 'Ocorreu um erro interno no servidor ao processar sua requisição.',
            codigoErro: 'INTERNAL_SERVER_ERROR' 
        });
    }
});
// Rota 3: Múltiplos parâmetros de rota. Ex: GET /categorias/eletronicos/produto/456
app.get('/categorias/:categoriaNome/produto/:produtoId', (req, res) => {
    // 15. req.params pode conter múltiplos parâmetros definidos na rota.
    const { categoriaNome, produtoId } = req.params;
    // Validações básicas
    if (!categoriaNome || categoriaNome.trim() === '' || !produtoId || isNaN(produtoId)) {
        console.warn([ERRO DE VALIDAÇÃO] Parâmetros de categoria/produto inválidos: Categoria=${categoriaNome}, ID=${produtoId});
        return res.status(400).json({
            mensagem: 'Nome da categoria ou ID do produto inválidos.',
            codigoErro: 'INVALID_CATEGORY_PRODUCT_PARAMS'
        });
    }
    console.log([SUCESSO] Solicitado produto ${produtoId} na categoria ${categoriaNome}.);
    res.status(200).json({
        mensagem: Produto ${produtoId} da categoria '${categoriaNome}' solicitado com sucesso.,
        dados: { categoria: categoriaNome, idProduto: parseInt(produtoId) }
    });
});
// Rota genérica para qualquer outra requisição não mapeada.
// Esta deve ser sempre a ÚLTIMA rota definida.
app.use((req, res) => {
    console.warn([404 NOT FOUND] Rota não encontrada: ${req.method} ${req.originalUrl});
    res.status(404).json({ 
        mensagem: 'Recurso não encontrado. Verifique a URL.',
        codigoErro: 'ROUTE_NOT_FOUND' 
    });
});
// 16. Iniciar o servidor Express.
app.listen(PORT, () => {
    console.log(Servidor Express operando na porta ${PORT});
    console.log(Para testar:);
    console.log(  - Produto válido: curl http://localhost:${PORT}/produtos/1);
    console.log(  - Produto inválido (ID não numérico): curl http://localhost:${PORT}/produtos/abc);
    console.log(  - Produto não encontrado: curl http://localhost:${PORT}/produtos/9999);
    console.log(  - Artigo válido: curl http://localhost:${PORT}/artigos/meu-primeiro-post);
    console.log(  - Artigo inexistente: curl http://localhost:${PORT}/artigos/artigo-inexistente);
    console.log(  - Artigo inválido (slug curto): curl http://localhost:${PORT}/artigos/a);
    console.log(  - Múltiplos parâmetros: curl http://localhost:${PORT}/categorias/livros/produto/123);
});

📋 Copiar

# Teste um produto válido
curl http://localhost:3000/produtos/1


Teste um produto com ID inválido (não numérico)



    
📚 Informações da Aula

    
Curso: API Completo - Node.js & Express

    
Tempo estimado: 25 minutos

    
Pré-requisitos: JavaScript básico



curl http://localhost:3000/produtos/abc


Teste um produto não encontrado (simulado)

curl http://localhost:3000/produtos/9999


Teste um artigo válido

curl http://localhost:3000/artigos/guia-completo-apis-rest


Teste um artigo inexistente (simulado)

curl http://localhost:3000/artigos/artigo-inexistente


Teste um artigo com slug inválido (muito curto)

curl http://localhost:3000/artigos/a


Teste múltiplos parâmetros

curl http://localhost:3000/categorias/tecnologia/produto/50

📋 Copiar

// Adicione esta rota ao seu arquivo server.js, antes da rota 404 genérica.
app.get('/usuarios/:username', (req, res) => {
    const { username } = req.params; // Desestruturação para capturar o username

    // Validação robusta para o username
    if (!username || username.trim() === '' || username.length < 4) {
        console.warn([ERRO DE VALIDAÇÃO] Username inválido recebido: '${username}');
        return res.status(400).json({
            mensagem: 'O nome de usuário deve ter pelo menos 4 caracteres e não pode ser vazio.',
            codigoErro: 'INVALID_USERNAME'
        });
    }
    try {
        let usuarioEncontrado = null;
        if (username.toLowerCase() === 'joao.silva') {
            usuarioEncontrado = {
                id: 1,
                username: 'joao.silva',
                email: '[email protected]',
                perfil: 'Administrador'
            };
        }
        if (usuarioEncontrado) {
            console.log([SUCESSO] Perfil do usuário '${username}' solicitado.);
            res.status(200).json(usuarioEncontrado);
        } else {
            // Simula um usuário não encontrado
            console.log([USUÁRIO NÃO ENCONTRADO] Username: '${username}');
            res.status(404).json({
                mensagem: Usuário com username '${username}' não encontrado.,
                codigoErro: 'USER_NOT_FOUND'
            });
        }
    } catch (erro) {
        console.error([ERRO INTERNO] Falha ao buscar perfil de usuário '${username}':, erro);
        res.status(500).json({
            mensagem: 'Ocorreu um erro interno no servidor ao processar sua requisição.',
            codigoErro: 'INTERNAL_SERVER_ERROR'
        });
    }
});

📋 Copiar

# Testar um usuário válido
curl http://localhost:3000/usuarios/joao.silva


Testar um usuário não encontrado

curl http://localhost:3000/usuarios/maria.souza


Testar com username muito curto (validação de 4 caracteres)

curl http://localhost:3000/usuarios/abc

📋 Copiar

🚀 Pronto para a próxima aula?

Continue sua jornada no desenvolvimento de APIs e domine Node.js & Express!

📚 Ver todas as aulas