Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/victorbadaro/node-api-sequelize-example
An example NodeJS API that uses the sequelize ORM
https://github.com/victorbadaro/node-api-sequelize-example
api api-rest backend node orm postgres sequelize sql
Last synced: 15 days ago
JSON representation
An example NodeJS API that uses the sequelize ORM
- Host: GitHub
- URL: https://github.com/victorbadaro/node-api-sequelize-example
- Owner: victorbadaro
- Created: 2021-12-25T21:33:36.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-22T19:03:39.000Z (over 1 year ago)
- Last Synced: 2024-12-02T23:13:10.636Z (2 months ago)
- Topics: api, api-rest, backend, node, orm, postgres, sequelize, sql
- Language: JavaScript
- Homepage:
- Size: 160 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# node-api-sequelize-example
[](./LEIAME.md)
## Summary
- [🧾 About](#-about)
- [🚀 Main technologies](#-main-technologies)
- [💻 Usage](#-usage)
- [👌 Requests](#-requests)
## 🧾 About
This project was made to be a simple example of a back-end application using the Sequelize ORM
## 🚀 Main technologies
- [Node.js](https://nodejs.org/)
- [Express](https://expressjs.com/)
- [PostgreSQL](https://www.postgresql.org/)
- [Sequelize](https://sequelize.org/)
- [Nodemon](https://nodemon.io/)
_(You can see all the dependencies in the [package.json](./package.json) file)_
## 💻 Usage
As you can see on [🚀 Main technologies](#-main-technologies) topic, this application depends on a postgreSQL database, so you must have it installed.
First things first:
1. Clone the project (you'll need a [personal access token](https://docs.github.com/pt/get-started/getting-started-with-git/about-remote-repositories#cloning-with-https-urls)):
```bash
$ git clone https://github.com/victorbadaro/node-api-sequelize-example.git
```
2. Access its directory:
```bash
$ cd node-api-sequelize-example
```
3. Install its dependencies:
```bash
$ yarn
# feel free to use another package manager, but you might want use yarn once there's already a yarn.lock file in the root directory
```
4. Create a `.env` file in the root directory with the same content that is in the [.env.example](./.env.example) file and fill the variables with your own data:
For example:
5. Create the database by running (your postgreSQL server must be running):
```bash
$ yarn sequelize db:create
```
6. Run all the migrations to create the database relations:
```bash
$ yarn sequelize db:migrate
```
7. Start the server by running the `dev` script:
```bash
$ yarn dev
```
## 👌 Requests
Now the server is ready to receive your requests! There's a [request collection](./request_collection.json) in the root directory so you can use (use [insomnia](https://insomnia.rest/) to import the collection). Remember to inform the server port in the `baseUrl` environment variable!
Here are the requests you can make:
- GET /users
- POST /users
```json
{
"name": "",
"email": ""
}
```
- GET /users/:id
- PUT /users/:id
```json
{
"name": "",
"email": ""
}
```
- DELETE /users/:id
- GET /products
- POST /products
```json
{
"description": "",
"user_id":
}
```
- GET /products/:id
- PUT /products/:id
```json
{
"description": ""
}
```
- DELETE /products/:id
---
This project was created and developed with ❤ by Victor Badaró