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

컬렉션과 요청 폴더로 테스트 정리

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

9강. 컬렉션과 요청 폴더로 테스트 정리

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

게임 기록·랭킹 API를 테스트하면서 게임 API 요청을 목적별 컬렉션과 폴더로 구조화하는 문제를 해결합니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

2. 학습 목표​

3. 핵심 개념​

컬렉션은 관련 요청, 인증, 변수, 스크립트를 묶는 실행 가능한 문서입니다. 폴더는 Players, Records, Rankings, Auth, Error Cases처럼 리소스나 시나리오로 나눕니다. 요청 이름에는 동작과 기대 결과를 함께 적으면 실행 결과만 보고도 실패 의미를 알 수 있습니다.

4. 단계별 실습​

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

  1. Game Ranking API 컬렉션을 만듭니다.
  2. 00 Health, 01 Players, 02 Records, 03 Rankings, 90 Error Cases 폴더를 만듭니다.
  3. 기존 요청을 옮기고 GET Health - 200, GET Missing Player - 404처럼 이름을 바꿉니다.
  4. 컬렉션 설명에 baseUrl과 실행 전제 조건을 적습니다.
PowerShell
New-Item -ItemType Directory -Force C:devgame-ranking-api-testsexports
# Postman에서 내보낸 파일을 이 폴더에 저장하고 비밀 값이 없는지 검사합니다.
Select-String -Path C:devgame-ranking-api-testsexports*.json -Pattern "Bearer eyJ|api[_-]?key"

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

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

폴더 순서가 테스트의 준비·실행·검증 흐름을 표현합니다. 컬렉션 수준 설정은 하위 요청에 상속할 수 있어 반복을 줄이고, 개별 요청은 필요한 값만 덮어씁니다.

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

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

컬렉션과 요청 폴더로 테스트 정리 미니 퀴즈

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

0 / 2
  1. 문제 1“컬렉션과 요청 폴더로 테스트 정리”의 위험한 선택을 피하려면 어떤 원칙을 적용해야 하나요?
  2. 문제 2“컬렉션과 요청 폴더로 테스트 정리” 실습 중 ‘export를 바로 커밋함’ 상황을 발견했습니다. 본문과 일치하는 설명은 무엇인가요?

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

LESSON STATUS

학습을 마쳤나요?

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

9강. 컬렉션과 요청 폴더로 테스트 정리 미완료 상태