본문으로 건너뛰기
DEVELOPMENT TOOLS · API CLIENT20강 공개

API 도구 기초집

Postman을 중심으로 HTTP 요청을 구성하고 FastAPI Swagger UI, PowerShell, curl.exe와 함께 게임 기록·랭킹 REST API의 성공과 실패 계약을 검증합니다.

강의 수20강
난이도입문 → 초급
최종 결과물반복 실행 가능한 게임 기록·랭킹 API 테스트 컬렉션
진행률을 불러오는 중...

과정 소개​

이 과정은 API를 브라우저에서 한 번 호출하는 수준을 넘어, 요청과 응답을 재현 가능한 검증 자산으로 만드는 법을 다룹니다. Postman Desktop 앱을 주 도구로 사용하지만 계정이나 클라우드 동기화는 필수가 아닙니다. 로그아웃 상태의 로컬 경량 클라이언트만으로도 핵심 실습을 진행할 수 있습니다.

모든 요청은 이전 과정에서 만든 http://127.0.0.1:8000 게임 기록·랭킹 FastAPI 서버를 대상으로 합니다. 서버 코드나 데이터베이스를 새로 만들지 않고 API 소비자 관점의 테스트에 집중합니다.

선수지식​

최종 결과물​

  • 플레이어 생성, 로그인, 게임 기록 생성, 랭킹 조회 요청이 포함된 Postman 컬렉션
  • 성공 상태·응답 JSON과 401·404·422 실패 응답을 검증하는 테스트
  • 실제 비밀 값이 비어 있는 공유용 환경 템플릿
  • 연속 실행 가능한 회귀 테스트 흐름과 실행 기록
  • Invoke-RestMethod, curl.exe로 재현하는 PowerShell 요청 예시

공식 문서 기준​

20강 학습 순서​

  1. API와 HTTP의 역할, API 클라이언트가 필요한 이유
  2. HTTP 요청·응답 구조와 상태 코드
  3. Postman 설치와 첫 GET 요청
  4. URL, Path Parameter, Query Parameter
  5. HTTP Method: GET, POST, PUT, PATCH, DELETE
  6. Header와 Content-Type
  7. JSON Request Body와 응답 데이터 읽기
  8. Postman 환경 변수와 변수 사용
  9. 컬렉션과 요청 폴더로 테스트 정리
  10. FastAPI Swagger UI와 Postman의 역할 차이
  11. POST 요청으로 게임 기록 생성하기
  12. 조회 API 테스트: 필터, 정렬, 페이지네이션
  13. PUT·PATCH·DELETE 요청과 안전한 검증
  14. 오류 응답과 상태 코드 테스트
  15. 인증 기초: Bearer Token과 JWT 요청
  16. API Key·토큰·환경 변수 보안 관리
  17. Pre-request Script와 Tests 기초
  18. 컬렉션 실행과 API 회귀 테스트 기초
  19. PowerShell Invoke-RestMethod와 curl.exe 사용
  20. 최종 실습: 게임 기록·랭킹 API 테스트 컬렉션 완성

COURSE ORIENTATION

과정 선택 안내​

학습 대상
Postman과 curl로 API 계약을 재현하고 오류 원인을 분리하려는 학습자
선수지식
웹 개발 또는 FastAPI 기초
최종 결과물
반복 실행 가능한 게임 기록·랭킹 API 테스트 컬렉션