<aside>

</aside>

안녕하세요! 실전 프로젝트 네 번째 시간이자, 4부의 마지막인 19강입니다! 🙌

18강에서는 드디어 ToDo 리스트 API의 핵심 CRUD 로직을 인메모리 방식으로 구현했습니다. 이제 우리 API는 할 일을 생성, 조회, 수정, 삭제하는 실제 기능을 갖추게 되었어요! (비록 서버를 껐다 켜면 데이터는 사라지지만요😅)

하지만 코드를 작성하는 것만큼 중요한 것이 있죠? 바로 제대로 작동하는지 확인하는 것입니다! 이번 시간에는 우리가 만든 API가 설계한 대로 정확하게 동작하는지 테스트하고, FastAPI가 자동으로 만들어준 API 문서를 꼼꼼히 점검하는 시간을 갖겠습니다.

FastAPI의 내장 **대화형 문서 도구(Swagger UI)**를 사용하여, 마치 API의 실제 사용자가 된 것처럼 각 엔드포인트를 직접 호출해보고 결과를 확인해 볼 거예요. 또한, 문서가 명확하고 이해하기 쉽게 작성되었는지, 빠진 부분은 없는지 함께 리뷰하며 API의 완성도를 높여보겠습니다.

자, 우리가 만든 작품을 직접 사용해보고 평가해 볼 시간입니다! 🧪📄

📚 챕터 소개

이번 19강에서는 18강에서 구현한 Task CRUD API 기능이 실제로 의도한 대로 동작하는지 테스트하는 데 중점을 둡니다. 별도의 테스트 도구를 설치할 필요 없이, FastAPI가 기본으로 제공하는 강력한 **대화형 API 문서(Swagger UI)**를 사용하여 각 엔드포인트(생성, 목록 조회, 상세 조회, 수정, 삭제)를 직접 호출하고 그 결과를 확인하는 방법을 배웁니다. 성공적인 요청뿐만 아니라, 존재하지 않는 ID로 조회/수정/삭제를 시도하는 등 오류 상황에 대한 처리(예: 404 Not Found 응답)도 제대로 이루어지는지 검증합니다.

동시에, 자동으로 생성된 API 문서를 주의 깊게 검토합니다. 엔드포인트 설명, 파라미터 정보, 요청/응답 스키마 등이 명확하고 정확하게 표시되는지 확인하고, Pydantic 모델 정의, 함수 독스트링(docstring), Field, Path 등의 요소들이 문서 품질에 어떻게 기여하는지 다시 한번 살펴봅니다. 또한, 17강에서 설정한 tags 옵션이 문서를 효과적으로 그룹화하는지 확인합니다. 이 과정을 통해 잘 만들어진 API 문서의 중요성을 깨닫고, 문서 품질을 개선하는 방법을 이해하게 됩니다.

🎯 챕터 목표

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

1. FastAPI의 **Swagger UI (/docs)**를 사용하여 API 엔드포인트를 대화형으로 테스트할 수 있습니다.
2. 구현된 Task CRUD 기능(생성, 목록/상세 조회, 수정, 삭제)이 정상적으로 동작하는지 확인할 수 있습니다.
3. 오류 처리(예: 존재하지 않는 ID 접근 시 404 반환)가 올바르게 작동하는지 테스트할 수 있습니다.
4. 자동 생성된 API 문서에서 엔드포인트 설명, 파라미터, 요청/응답 스키마, 태그 등을 검토하고 평가할 수 있습니다.
5. 코드(주석, Pydantic 모델 등)가 API 문서 품질에 미치는 영향을 이해하고, 문서 개선 방향을 생각할 수 있습니다.

🏗️ 이번 강의에서 테스트할 프로젝트 구조 및 코드