<aside>

</aside>

안녕하세요! FastAPI 2부 '응답 처리 심화'의 네 번째 시간, 13강입니다! 다들 활기차게 시작해볼까요? 😉

12강에서는 HTTP 상태 코드를 통해 요청 처리 결과를 명확하게 전달하는 방법을 배웠습니다. status_code 매개변수와 Response 객체를 이용해 응답의 의미를 더욱 풍부하게 만들 수 있었죠.

이번 시간에는 HTTP 메시지의 또 다른 중요한 구성 요소인 **헤더(Header)**와 **쿠키(Cookie)**를 다루는 방법을 알아봅니다. 응답에 커스텀 헤더를 추가하여 부가 정보를 전달하거나, 쿠키를 설정하여 사용자의 상태(예: 로그인 정보, 설정)를 브라우저에 저장하고 추적하는 방법을 배우게 될 거예요. 또한, 클라이언트가 보내온 쿠키를 FastAPI에서 어떻게 읽어오는지도 살펴봅니다.

헤더와 쿠키를 자유자재로 다루며 API의 기능을 더욱 확장해 봅시다! 🍪✉️

📚 챕터 소개

이번 13강에서는 HTTP 요청 및 응답 메시지의 중요한 부분인 **헤더(Header)**와 **쿠키(Cookie)**를 FastAPI에서 관리하는 방법을 배웁니다.

먼저, HTTP 헤더가 요청과 응답에 대한 추가 정보(메타데이터)를 전달하는 역할을 한다는 것을 이해하고, FastAPI 응답에 커스텀 헤더를 추가하는 방법을 실습합니다. 이를 위해 경로 작동 함수에 Response 객체를 주입받아 headers 속성을 수정하는 방식을 사용합니다.

다음으로, HTTP 쿠키의 개념과 목적(상태 관리)을 알아보고, 서버가 클라이언트 브라우저에 쿠키를 설정하도록 Set-Cookie 헤더를 보내는 방법을 배웁니다. FastAPI에서는 주입받은 Response 객체의 set_cookie() 메서드를 사용하여 쿠키의 이름, 값, 만료 시간, 보안 속성(HttpOnly, Secure, SameSite) 등을 설정할 수 있습니다.

마지막으로, 클라이언트가 요청에 담아 보낸 쿠키 값을 FastAPI에서 읽어오는 방법을 배웁니다. fastapi에서 Cookie 함수를 임포트하여 경로 작동 함수의 매개변수로 선언하면, 특정 이름의 쿠키 값을 쉽게 가져올 수 있습니다.

🎯 챕터 목표

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

1. HTTP 헤더와 쿠키의 역할과 목적을 설명할 수 있습니다.
2. FastAPI 경로 작동 함수에서 Response 객체를 주입받아 응답에 커스텀 헤더를 설정할 수 있습니다.
3. response.set_cookie() 메서드를 사용하여 응답에 쿠키를 설정하고, 다양한 속성(만료 시간, 경로, 보안 속성 등)을 지정할 수 있습니다.
4. fastapi의 Cookie 함수를 사용하여 요청 헤더에 포함된 쿠키 값을 읽어올 수 있습니다.
5. 쿠키 사용 시 고려해야 할 주요 보안 속성(HttpOnly, Secure, SameSite)의 의미를 이해합니다.