본문으로 건너뛰기
API 도구 기초집LESSON 10

FastAPI Swagger UI와 Postman의 역할 차이

난이도입문 → 초급
예상 시간30분
선수지식이전 강의

10강. FastAPI Swagger UI와 Postman의 역할 차이

1. 이번 강의에서 해결할 문제​

게임 기록·랭킹 API를 테스트하면서 자동 API 문서와 반복 테스트 도구의 역할을 구분해 함께 사용하는 문제를 해결합니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

2. 학습 목표​

3. 핵심 개념​

FastAPI는 OpenAPI 스키마를 바탕으로 기본 Swagger UI(/docs)와 ReDoc(/redoc)을 제공합니다. Swagger UI는 현재 서버 계약을 탐색하고 빠르게 한 번 호출하기 좋습니다. Postman은 여러 환경, 요청 순서, 변수, 스크립트, 회귀 실행을 장기적으로 관리하는 데 적합합니다.

4. 단계별 실습​

실습 경로: C:\dev\game-ranking-api-tests

  1. 브라우저에서 http://127.0.0.1:8000/docs를 열어 플레이어 스키마를 확인합니다.
  2. Try it out으로 한 번 호출하고 생성된 curl 예시를 읽습니다.
  3. 같은 요청을 Postman에 저장하고 이름·환경 변수·예상 상태를 추가합니다.
  4. /openapi.json에서 실제 경로와 메서드를 확인합니다.
PowerShell
$baseUrl = "http://127.0.0.1:8000"
Invoke-RestMethod -Uri "$baseUrl/openapi.json" | Select-Object -ExpandProperty paths

Postman의 버튼·탭 이름은 버전에 따라 달라질 수 있습니다. 메뉴가 다르면 설치된 앱의 도움말과 Postman 공식 문서를 먼저 확인합니다.

5. 요청과 응답이 동작하는 이유​

FastAPI 라우터와 Pydantic 모델이 OpenAPI 문서의 경로·입력·응답 스키마를 만듭니다. Postman 요청은 그 계약을 소비해 반복 검증 자산으로 저장합니다.

6. 자주 하는 실수와 해결법​

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

FastAPI Swagger UI와 Postman의 역할 차이 미니 퀴즈

선택 즉시 정답과 해설을 확인할 수 있습니다. 결과는 이 브라우저에만 저장됩니다.

0 / 2
  1. 문제 1“FastAPI Swagger UI와 Postman의 역할 차이” 실습을 안전하게 진행하기 위한 판단으로 가장 알맞은 것은 무엇인가요?
  2. 문제 2“FastAPI Swagger UI와 Postman의 역할 차이” 실습 중 ‘Swagger UI만 있으면 회귀 테스트도 끝난다고 생각함’ 상황을 발견했습니다. 본문과 일치하는 설명은 무엇인가요?

답을 선택하면 진행 결과가 자동으로 저장됩니다.

LESSON STATUS

학습을 마쳤나요?

직접 실습과 점검 질문까지 확인한 뒤 완료로 표시하세요.

10강. FastAPI Swagger UI와 Postman의 역할 차이 미완료 상태