<aside>

</aside>

안녕하세요! 😊 FastAPI 강의 4번째 시간입니다! 다들 잘 따라오고 계신가요?

지난 3강에서는 다양한 URL 경로와 HTTP 메서드를 처리하는 라우팅의 기초를 배웠습니다. 여러 개의 문(엔드포인트)을 만들고 각 문마다 다른 역할(GET, POST 등)을 부여하는 방법을 익혔죠.

하지만 지금까지 만든 API는 조금 정적이었어요. 예를 들어 항상 모든 아이템 목록만 반환했죠. 실제 서비스에서는 '특정 ID의 아이템 정보만 줘!' 라거나 '최신 10개만 보여줘!' 와 같이 동적인 요청을 처리해야 할 때가 훨씬 많습니다.

이번 시간에는 바로 이 동적인 API를 만드는 방법을 배웁니다! URL 경로 자체에 변수를 넣는 **경로 매개변수(Path Parameter)**와, URL 뒤에 ?를 붙여 추가 정보를 전달하는 **쿼리 매개변수(Query Parameter)**를 사용하는 방법을 알아볼 거예요.

API를 더욱 똑똑하고 유연하게 만들어 봅시다! 🤓

📚 챕터 소개

이번 4강에서는 API가 클라이언트로부터 입력을 받아 동적으로 응답을 생성하도록 만드는 핵심 방법 두 가지, 경로 매개변수와 쿼리 매개변수를 배웁니다.

• 경로 매개변수는 URL 경로의 일부가 되어 특정 리소스를 식별하는 데 사용됩니다 (예: /items/123 에서 123). FastAPI에서는 경로 문자열 안에 중괄호 {} 를 사용하여 정의하고, 함수 인자로 받아 사용합니다.
• 쿼리 매개변수는 URL 경로 뒤에 ?key=value 형태로 추가되어 필터링, 정렬, 페이징 등 부가적인 옵션을 전달하는 데 사용됩니다 (예: /items?skip=10&limit=5). FastAPI에서는 함수 인자로 간단히 선언하여 사용합니다.

또한, 타입 힌트를 사용하여 FastAPI가 자동으로 데이터를 검증하고 변환하도록 하는 강력한 기능을 활용해보고, 매개변수에 기본값을 설정하여 **선택적(Optional)**으로 만드는 방법도 알아봅니다. 이 강의를 통해 여러분의 API가 훨씬 더 유용하고 실용적으로 발전할 것입니다!

🎯 챕터 목표

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

1. 경로 매개변수를 정의하고 함수 인자로 받아 사용할 수 있습니다.
2. 쿼리 매개변수를 정의하고 함수 인자로 받아 사용할 수 있습니다.
3. 타입 힌트를 사용하여 경로 및 쿼리 매개변수의 타입을 선언하고, FastAPI의 자동 데이터 검증 및 변환 기능을 활용할 수 있습니다.
4. 매개변수에 기본값을 설정하여 선택적(Optional) 매개변수를 만들 수 있습니다.
5. 하나의 경로 작동 함수에서 경로 매개변수와 쿼리 매개변수를 함께 사용할 수 있습니다.