Spring Boot으로 영화 추천 API 구축 🎬

Source: Dev.to

최근에 Java와 Spring Boot을 사용해 영화 및 TV 프로그램 추천 플랫폼용 백엔드 API를 만들었습니다.
이 프로젝트의 목표는 REST API 설계 연습, 인증 구현, 외부 API 연동이었습니다.

Features

• TMDB API를 이용한 영화·TV 프로그램 검색
• JWT를 이용한 사용자 인증
• 즐겨찾는 영화·프로그램 저장
• 콘텐츠 평점 매기기
• 트렌딩 콘텐츠 조회
• RESTful API 설계
• Swagger / OpenAPI를 활용한 API 문서화

Tech Stack

Backend

• Java 21
• Spring Boot
• Spring Security
• JWT Authentication
• Spring Data JPA

Database

• PostgreSQL

External API

• TMDB API (The Movie Database)

Documentation

• Swagger / OpenAPI

Example API Request

Get trending content

GET /content/trending

Response

{
  "page": 1,
  "results": [
    {
      "title": "War Machine",
      "release_date": "2026-02-12",
      "vote_average": 7.1
    }
  ]
}

Project Architecture

애플리케이션은 계층형 아키텍처를 따릅니다:

Controller → Service → Repository → Database

이 구조는 코드를 체계적이고 유지보수하기 쉽게 만들어 줍니다.

API Documentation

API는 Swagger / OpenAPI를 사용해 문서화되어 있어 엔드포인트를 쉽게 탐색하고 테스트할 수 있습니다.

What I Learned

• REST API 설계
• Spring Security를 이용한 인증 구현
• JWT를 활용한 권한 부여
• 외부 API 연동
• 계층형 아키텍처를 이용한 백엔드 프로젝트 구조화

GitHub Repository

전체 프로젝트는 다음에서 확인할 수 있습니다:
https://github.com/alejandrotg-code/tv-and-movie-db