Book Store REST API

Um simples CRUD utilizando expressjs para criar uma REST API

Instalação

1. Você precisa instalar as seguintes dependencias em seu sistema:

• nodejs >=14.17.6
• npm >=6.14.15
• git
• postgres >= 12.0

Normalmente npm já vem instalado com nodejs

2. Clone o projeto:

git clone https://github.com/richardfsilva/book-store-rest-api
cd book-store-rest-api

3. Instale as dependencias do projeto:

npm install

4. Crie o banco de dados:

npx sequelize-cli db:create

5. Crie a tabela

npx sequelize-cli db:migrate

Executando Localmente

Inicie o servidor:

npm run start

O servidor será inicializado em localhost:5000

Usando

Você pode usar o postman, curls ou outro cliente API para fazer as requisições HTTP.

Ver todos os livro

GET /api/books

Exemplo

curl http://localhost:5000/api/books

Procurar por um livro

GET /api/books/<id>

Parametro	Tipo	Descrição
id	integer	Obrigatório. Id do livro à procurar

Exemplo

curl http://localhost:5000/api/books/1

Adicionar livro

POST /api/books

Parametro	Tipo	Descrição
name	string	Obrigatório. Nome do livro
author	string	Obrigatório. Nome do Autor do livro
year_released	integer	Obrigatório. Ano do lançamento do livro
rating	float	Valor 0 por padrão. Avaliação do livro
qtd	integer	Obrigatório. Quantidade disponível

Exemplo

curl -X POST -H "Content-Type: application/json" -d '{"name": "O Cortiço", "author": "Aluísio Azevedo", "year_released": 1890, "rating": 3.5, "qtd": 150}' http://localhost:5000/api/books/

Alterar um livro

PUT /api/books/<id>

Parametro	Tipo	Descrição
id	integer	Obrigatório. Id do livro à alterar

Exemplo

curl -X PUT -H "Content-Type: application/json" -d '{"rating": 4.6}' http://localhost:5000/api/books/1

Apagar um livro

DELETE /api/books/<id>

Parametro	Tipo	Descrição
id	integer	Obrigatório. Id do livro à apagar

Exemplo

curl -X DELETE http://localhost:5000/api/books/1

Licença

MIT