revisaoapi

Projeto de revisão de API para os alunos do 2TDSPM da FIAP

Tecnologias

• Java 17
• Gradle
• Spring Boot 3.2.5
• Spring Data JPA
• Spring Web Starter
• Spring Validation Starter
• Spring HATEOAS
• Springdoc OpenAPI + Swagger
• H2 Database
• REST
• DTO

Ferramentas

• IntelliJ
• Postman

API Reference

Obter todos os clientes (findAll clienteDTO)

  GET /clientes

Obter cliente por id (findById clienteDTO)

  GET /clientes/${id}

Parâmetro	Tipo	Descrição
id	Long	Obrigatório. Id do cliente a ser buscado

Gravar cliente (save)

  POST /clientes

Body:

{
    "nome": "Exemplo",
    "email": "exemplo@email.com",
    "senha": "123456"
}

Parâmetro	Tipo	Descrição
nome	String	Nome do cliente a ser gravado
email	String	E-mail do cliente a ser gravado
senha	String	Senha do cliente a ser gravado

Atualizar cliente (update)

  PUT /clientes/${id}

Parâmetro	Tipo	Descrição
id	Long	Obrigatório. Id do cliente a ser atualizado

Body:

{
    "nome": "Exemplo",
    "email": "exemplo@email.com",
    "senha": "123456"
}

Parâmetro	Tipo	Descrição
nome	String	Nome do cliente a ser atualizado
email	String	E-mail do cliente a ser atualizado
senha	String	Senha do cliente a ser atualizado

Excluir cliente (delete)

  DELETE /clientes/${id}

Parâmetro	Tipo	Descrição
id	Long	Obrigatório. Id do cliente a ser excluído

API Reference

Obter todos os cursos (findAll cursoDTO)

  GET /cursos

Obter cliente por id (findById cursoDTO)

  GET /cursos/${id}

Parâmetro	Tipo	Descrição
id	Long	Obrigatório. Id do curso a ser buscado

Gravar cursos (save)

  POST /cursos

Body:

{
   "titulo": "Python",
    "descricao": "Curso de python",
    "instrutor" : "Leonardo",
    "duracao" : 1,
    "nivel" : "2",
    "preco" : 20
}

Parâmetro	Tipo	Descrição
titulo	String	Título do curso
descricao	String	Descrição do curso
instrutor	String	Instrutor do curso
duracao	int	Duração do curso
nivel	String	Nível do curso
preco	double	Preço do curso

Atualizar curso (update)

  PUT /cursos/${id}

Parâmetro	Tipo	Descrição
id	Long	Obrigatório. Id do curso a ser atualizado

Body:

{
    "titulo": "Python",
    "descricao": "Curso de python",
    "instrutor" : "Leonardo",
    "duracao" : 1,
    "nivel" : "2",
    "preco" : 20
}

Parâmetro	Tipo	Descrição
titulo	String	Título do curso
descricao	String	Descrição do curso
instrutor	String	Instrutor do curso
duracao	int	Duração do curso
nivel	String	Nível do curso
preco	double	Preço do curso

Excluir curso (delete)

  DELETE /cursos/${id}

Parâmetro	Tipo	Descrição
id	Long	Obrigatório. Id do curso a ser excluído