API REST de catálogo de filmes construída com Spring Boot. Os filmes seguem o modelo de dados do TMDB (título, sinopse, data de lançamento, popularidade, nota média e número de votos), e usuários autenticados podem montar sua lista de favoritos.
- CRUD de filmes com validações de negócio (título obrigatório, filme duplicado, filme inexistente)
- Consultas: filme com a maior nota e filmes com popularidade acima de um valor
- Lista de filmes favoritos por usuário
- Autenticação com JWT e senhas com BCrypt (Spring Security, sessão stateless)
- Tratamento centralizado de erros com respostas padronizadas
- Documentação interativa com Swagger / OpenAPI
- Java 17
- Spring Boot 3.4 (Web, Data JPA, Security, Validation, Actuator)
- MySQL
- Auth0 java-jwt
- springdoc-openapi
- Lombok
- Maven
Todas as rotas exigem o cabeçalho Authorization: Bearer <token>, exceto POST /login e a documentação.
| Método | Rota | Descrição |
|---|---|---|
| POST | /login |
Autentica o usuário e devolve o token JWT |
| Método | Rota | Descrição |
|---|---|---|
| GET | /api |
Lista todos os filmes |
| GET | /api/{id} |
Busca um filme pelo id |
| POST | /api |
Cadastra um filme |
| PUT | /api |
Edita um filme |
| DELETE | /api/{id} |
Remove um filme |
| GET | /api/maiorNota |
Filme com a maior nota |
| GET | /api/popularidadeMaiorQue/{n} |
Filmes com popularidade maior que n |
| Método | Rota | Descrição |
|---|---|---|
| GET | /favoritar |
Lista as listas de favoritos |
| GET | /favoritar/{id} |
Busca uma lista de favoritos pelo id |
| POST | /favoritar |
Cria uma lista de favoritos |
| PUT | /favoritar |
Adiciona um filme a uma lista existente |
Pré-requisitos: Java 17 e um MySQL acessível.
-
Clone o repositório e entre na pasta do projeto:
git clone https://github.com/MateusKen/TMDB_API.git cd TMDB_API/api -
Crie o banco
api_springno MySQL e ajuste usuário e senha emsrc/main/resources/application.properties. Variáveis de ambiente opcionais:Variável Padrão Uso MYSQL_HOSTlocalhostHost do MySQL JWT_SECRETvalor de desenvolvimento Segredo usado para assinar os tokens No perfil
prod, a conexão vem deDATASOURCE_URL,DATASOURCE_USERNAMEeDATASOURCE_PASSWORD. -
Suba a aplicação:
./mvnw spring-boot:run
-
Acesse a documentação em
http://localhost:8080/swagger-ui.html.
api/src/main/java/br/com/projeto/api
├── controle/ # controladores REST (login, filmes, favoritos)
├── servico/ # regras de negócio
├── modelo/ # entidades, DTOs e repositórios JPA
├── validacao/ # validações de negócio plugáveis por tipo
└── infra/ # segurança (JWT), tratamento de erros e OpenAPI
- Validações como componentes. Cada regra é uma classe que implementa
ValidacaoFilme<T>; o serviço recebe a lista injetada pelo Spring e aplica as que se encaixam no tipo. Adicionar uma regra nova não exige mexer no serviço. - Segurança stateless. Um filtro valida o JWT a cada requisição, sem sessão no servidor.
Mateus Kenzo Iochimoto · LinkedIn