Este é um projeto simples de API REST criada com Node.js, Express e MongoDB (Mongoose).
Permite criar, listar, atualizar e deletar usuários a partir de requisições HTTP.
- Node.js (plataforma JavaScript para criar servidores e aplicações back-end)
- Express (framework minimalista para criar rotas e gerenciar requisições HTTP)
- MongoDB (banco de dados NoSQL usado para armazenar os dados dos usuários)
- Mongoose (biblioteca que facilita a conexão e modelagem de dados no MongoDB)
- dotenv (para carregar variáveis de ambiente de forma segura através do arquivo
.env) - Validator (usada para validar campos, como verificar se um e-mail é válido)
- CORS (para permitir acesso da interface HTML sem bloqueios de origem cruzada)
- MongoDB Compass (interface gráfica para visualizar, buscar e editar os dados no MongoDB)
mongoose-demo/
├── controllers/
│ └── userController.js
│
├── models/
│ └── user.js
│
├── routes/
│ └── userRoutes.js
│
├── node_modules/
│
├── index.html
│
├── .env
│
├── server.js
│
├── package.json
│
├── package-lock.json
│
└── README.md
| Método | Rota | Descrição |
|---|---|---|
| GET | /users |
Lista todos os usuários |
| GET | /users/:id |
Mostra um usuário específico por ID |
| POST | /users |
Cria um novo usuário |
| PUT | /users/:id |
Atualiza os dados de um usuário |
| DELETE | /users/:id |
Remove um usuário do banco de dados |
-
Clone o repositório:
git clone https://github.com/Sara-source01/api-users-node-mongoose-.git
-
Instale as dependências: npm install express mongoose dotenv cors validator
-
Configure o arquivo .env: MONGO_URI=mongodb://localhost:27017/mongoose_demo PORT=3000
-
Inicie o servidor: node server.js
🧪 Testando a API Você pode testar a API de três formas:
-
Com Postman ou Insomnia: Envie requisições para: http://localhost:3000/users
-
Com interface HTML (index.html): Abra o arquivo index.html no navegador, preencha os campos de nome e e-mail e clique em "Create". Isso envia um POST para a rota /users usando fetch().
Atenção: o servidor precisa estar rodando e com CORS ativado.
A biblioteca CORS permite que navegadores (como uma página HTML local) consigam acessar a API sem bloqueio.
- Via MongoDB Compass: Abra o MongoDB Compass.
Conecte-se a: mongodb://localhost:27017
Acesse o banco de dados mongoose_demo.
Clique na coleção users para ver os dados inseridos pela API ou HTML.
Dessa forma, você pode acompanhar visualmente as alterações feitas pelos endpoints da API.
📄 Licença
Este projeto é livre para estudos e testes.
Desenvolvido por Sara George 🚀
Sinta-se à vontade para entrar em contato ou contribuir com melhorias!