Skip to content

devrafael-santos/toproduct-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Top Product API 🛍️

📖 Sobre o Projeto

API REST para gerenciamento de produtos, desenvolvida com Spring Boot. Oferece operações CRUD completas com suporte a paginação e ordenação.

🔗 URL Base

https://toproduct-api-production.up.railway.app

🚀 Endpoints

Produtos

  • GET /products - Lista todos os produtos (paginado)
  • GET /products/{id} - Obtém um produto específico
  • POST /products - Cria um novo produto
  • PUT /products/{id} - Atualiza um produto existente
  • DELETE /products/{id} - Remove um produto

Listar Produtos

GET /products
  • Suporta paginação e ordenação
  • Parâmetros:
    • page (default: 0)
    • size (default: 20)
    • sort (ex: price,asc)

Buscar Produto por ID

GET /products/{id}
  • ID no formato UUID

Criar Produto

POST /products

Exemplo de corpo da requisição:

{
  "name": "Produto Exemplo",
  "description": "Descrição do produto",
  "price": 99.90,
  "available": true
}

Atualizar Produto

PUT /products/{id}

Exemplo de corpo da requisição:

{
  "name": "Produto Atualizado",
  "description": "Nova descrição",
  "price": 149.90,
  "available": true
}

Deletar Produto

DELETE /products/{id}

📊 Modelo de Dados

Product

Campo Tipo Obrigatório
id UUID Sim*
name String Sim
description String Não
price Double Sim
available Boolean Não

*Gerado automaticamente

📝 Códigos de Resposta

  • 200: Operação realizada com sucesso
  • 204: Operação realizada com sucesso (sem conteúdo)
  • 400: Produto não encontrado ou dados inválidos

🔄 Paginação

A API suporta paginação em suas consultas:

GET /products?page=0&size=20&sort=name,asc

🛠️ Tecnologias Utilizadas

  • Spring Boot
  • Spring Data JPA
  • MySQL
  • Swagger/OpenAPI
  • Junit5
  • Docker

📚 Documentação

Documentação completa da API disponível via Swagger UI em:

https://toproduct-api-production.up.railway.app/swagger-ui.html

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages