<aside>

</aside>

안녕하세요! FastAPI 강의 2부의 두 번째 시간, 11강에 오신 것을 환영합니다! 🎉

지난 10강에서는 response_model을 사용하여 API 응답의 스키마를 정의하고 JSON 데이터를 필터링하는 방법을 배웠습니다. API 응답을 더 깔끔하고 예측 가능하게 만들 수 있었죠! 👍

하지만 웹 애플리케이션이 항상 JSON 데이터만 응답하는 것은 아닙니다. 때로는 웹 브라우저에 직접 보여줄 HTML 페이지를 반환해야 할 수도 있고, 간단한 텍스트 메시지만 보내야 할 수도 있으며, 사용자를 **다른 페이지로 이동(리디렉션)**시켜야 할 때도 있습니다.

이번 시간에는 FastAPI가 제공하는 다양한 Response 클래스들을 사용하여, 이렇게 JSON 이외의 다양한 형식의 응답을 어떻게 생성하고 반환하는지 알아볼 거예요. API 응답의 표현력을 한층 더 높여봅시다! 🎨

📚 챕터 소개

이번 11강에서는 FastAPI의 기본적인 JSON 응답 메커니즘을 넘어서, HTML, 일반 텍스트(Plain Text), 리디렉션(Redirect) 등 다양한 종류의 HTTP 응답을 직접 생성하고 반환하는 방법을 배웁니다.

FastAPI는 Starlette 프레임워크를 기반으로 하며, Starlette이 제공하는 여러 편리한 Response 서브클래스들을 그대로 사용할 수 있습니다. HTMLResponse, PlainTextResponse, RedirectResponse 등의 클래스를 fastapi.responses 모듈에서 가져와 사용하는 방법을 실습합니다.

경로 작동 함수에서 이러한 Response 객체를 직접 생성하여 반환함으로써, 응답의 내용(content), 상태 코드(status code), 미디어 타입(media type, 예: text/html, text/plain), 헤더(headers) 등을 완전히 제어할 수 있습니다. 또한, 데코레이터의 response_class 매개변수를 사용하여 특정 경로에 대한 기본 응답 클래스를 지정하는 방법도 알아봅니다. 이를 통해 JSON 외의 응답 형식을 보다 쉽고 유연하게 처리하는 기법을 익힙니다.

🎯 챕터 목표

이 강의를 마치면 여러분은 다음을 할 수 있게 됩니다:

1. API 응답이 JSON 외에도 다양한 형식(HTML, Plain Text 등)을 가질 수 있음을 이해합니다.
2. fastapi.responses 모듈에서 HTMLResponse, PlainTextResponse, RedirectResponse 등 다양한 Response 클래스를 가져와 사용할 수 있습니다.
3. 경로 작동 함수에서 명시적으로 Response 객체를 생성하고 반환하여 응답 내용과 형식을 제어할 수 있습니다.
4. 경로 작동 데코레이터의 response_class 매개변수를 사용하여 특정 경로의 기본 응답 클래스를 지정할 수 있습니다.
5. StreamingResponse, FileResponse 등 다른 종류의 응답 클래스가 있다는 것을 인지합니다. (자세한 내용은 추후 강의)

🏗️ 이번 강의에서 만들 프로젝트 구조 및 전체 코드