Introdução

O desenvolvimento de API’s é uma parte essencial em qualquer aplicação web moderna. Hoje, vamos aprender como criar uma API RESTful usando Node.js, Express, MongoDB e Mongoose.

Passo 1: Configurando o ambiente

Antes de começar, certifique-se de ter o Node.js instalado em seu computador. Você pode baixá-lo em https://nodejs.org.

Após a instalação do Node.js, abra o terminal e execute o seguinte comando para instalar o Express:

npm install express

Em seguida, instale o MongoDB em sua máquina. Você pode encontrar instruções de instalação adequadas para o seu sistema operacional em https://docs.mongodb.com/manual/installation/.

Por fim, instale o Mongoose, uma biblioteca Node.js que fornece uma camada de modelagem para interagir com o MongoDB:

npm install mongoose

Passo 2: Criando o servidor

Crie um arquivo chamado server.js e adicione o seguinte código:

    const express = require('express');
    const mongoose = require('mongoose');
    const app = express();

    mongoose.connect('mongodb://localhost/minhaapi', {
      useNewUrlParser: true,
      useUnifiedTopology: true
    }).then(() => {
      console.log('Conectado ao MongoDB');
    }).catch((error) => {
      console.log('Erro ao conectar ao MongoDB: ' + error);
    });

    app.listen(3000, () => {
      console.log('Servidor rodando na porta 3000');
    });
    

Este código cria uma instância do servidor Express e conecta-se ao banco de dados MongoDB usando o Mongoose.

Passo 3: Criando os modelos

Em seguida, crie um diretório chamado models e dentro dele crie um arquivo chamado produto.js. Adicione o seguinte código:

    const mongoose = require('mongoose');

    const ProdutoSchema = new mongoose.Schema({
      nome: String,
      descricao: String,
      preco: Number
    });

    module.exports = mongoose.model('Produto', ProdutoSchema);
    

Este código define o esquema para o modelo Produto, que será usado para interagir com a coleção produtos no MongoDB.

Passo 4: Criando as rotas

Crie um diretório chamado routes e dentro dele crie um arquivo chamado produtoRoute.js. Adicione o seguinte código:

    const express = require('express');
    const router = express.Router();
    const Produto = require('../models/produto');

    router.get('/produtos', async (req, res) => {
      try {
        const produtos = await Produto.find();
        return res.json(produtos);
      } catch (error) {
        return res.status(500).json({ error: 'Erro ao buscar produtos' });
      }
    });

    router.post('/produtos', async (req, res) => {
      try {
        const produto = await Produto.create(req.body);
        return res.json(produto);
      } catch (error) {
        return res.status(500).json({ error: 'Erro ao criar produto' });
      }
    });

    module.exports = router;
    

Este código define as rotas para buscar todos os produtos e criar um novo produto. Ele usa o modelo Produto para interagir com o banco de dados.

Passo 5: Configurando as rotas

Volte ao arquivo server.js e adicione o seguinte código abaixo da linha const app = express();:

    const produtoRoute = require('./routes/produtoRoute');
    app.use('/api', produtoRoute);
    

Este código configura as rotas para acessar as funcionalidades de busca e criação de produtos através da URL /api.

Passo 6: Testando a API

Com tudo configurado, você pode testar a API utilizando ferramentas como o Postman ou Insomnia. Faça requisições GET para http://localhost:3000/api/produtos e POST para http://localhost:3000/api/produtos para listar e criar produtos, respectivamente.

Conclusão

Parabéns! Você aprendeu como criar uma API RESTful usando Node.js, Express, MongoDB e Mongoose. Agora você pode expandir essa API adicionando outras funcionalidades, como atualização e exclusão de produtos.