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

최종 실습: 게임 기록·랭킹 API 테스트 컬렉션 완성

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

20강. 최종 실습: 게임 기록·랭킹 API 테스트 컬렉션 완성

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

게임 기록·랭킹 API를 테스트하면서 성공·실패·인증·회귀 검증을 포함한 게임 기록·랭킹 API 테스트 컬렉션을 완성하는 문제를 해결합니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

2. 학습 목표​

3. 핵심 개념​

최종 결과물은 단순한 요청 모음이 아니라 실행 전제, 환경 템플릿, 성공·실패 assertion, 데이터 수명 주기, 명령줄 재현 예시를 갖춘 테스트 자산입니다. 최소 흐름은 플레이어 생성→로그인→게임 기록 생성→랭킹 조회이며, 인증 실패와 입력 검증 실패도 독립 요청으로 포함합니다.

4. 단계별 실습​

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

  1. 컬렉션 폴더를 00 Health, 01 Players, 02 Auth, 03 Records, 04 Rankings, 90 Error Cases 순서로 정리합니다.
  2. 플레이어 생성 201, 로그인 200, 기록 생성 201, 랭킹 조회 200 테스트를 작성합니다.
  3. 필수 필드 누락 422, 토큰 없음 401, 없는 리소스 404를 추가합니다.
  4. baseUrl은 예시 로컬 값, accessToken은 빈 값인 환경 템플릿을 export합니다.
  5. 컬렉션을 연속 두 번 실행하고 민감 정보 검색 후 결과물을 Git에 추가합니다.
PowerShell
$baseUrl = "http://127.0.0.1:8000"
$player = @{ nickname = "final-api-learner"; region = "KR" } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "$baseUrl/players" -ContentType "application/json" -Body $player

curl.exe -i "$baseUrl/rankings?season=2026&limit=10"

Get-ChildItem C:devgame-ranking-api-testsexports -File | `
  Select-String -Pattern "eyJ[A-Za-z0-9_-]+.|Bearer [^{}]|api[_-]?key"

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

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

생성 응답의 ID와 로그인 토큰을 변수로 전달하면 실제 사용자 흐름을 한 번의 실행으로 검증할 수 있습니다. 성공과 실패 assertion이 함께 있어야 계약 변화가 즉시 드러나며, 빈 비밀 변수 템플릿은 안전하게 공유할 수 있습니다.

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

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

최종 실습: 게임 기록·랭킹 API 테스트 컬렉션 완성 미니 퀴즈

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

0 / 2
  1. 문제 1“최종 실습: 게임 기록·랭킹 API 테스트 컬렉션 완성” 작업 전 검토에서 채택해야 할 안전 기준은 무엇인가요?
  2. 문제 2“최종 실습: 게임 기록·랭킹 API 테스트 컬렉션 완성”에서 ‘현재 데이터에만 맞는 고정 ID 사용’ 문제가 생겼습니다. 가장 알맞은 진단 또는 대응은 무엇인가요?

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

LESSON STATUS

학습을 마쳤나요?

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

20강. 최종 실습: 게임 기록·랭킹 API 테스트 컬렉션 완성 미완료 상태