11강. POST 요청으로 게임 기록 생성하기

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

게임 기록·랭킹 API를 테스트하면서 인증된 POST 요청으로 게임 기록을 만들고 생성 응답을 검증하는 문제를 해결합니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

✓2. 학습 목표

✓이 강의를 마치면

• 이번 주제의 HTTP 계약을 설명할 수 있습니다.
• Postman에서 성공과 실패 요청을 각각 구성할 수 있습니다.
• PowerShell에서 핵심 요청을 재현하고 결과를 판정할 수 있습니다.

◇3. 핵심 개념

게임 기록 생성은 플레이어·게임·점수·승패를 하나의 JSON으로 보냅니다. 생성 성공은 일반적으로 201과 새 리소스 식별자를 기대합니다. 요청을 반복하면 중복 데이터가 생길 수 있으므로 테스트용 고유 값과 정리 전략을 마련합니다.

✎4. 단계별 실습

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

1. 02 Records 폴더에 POST Record - 201 요청을 만듭니다.
2. URL은 {{baseUrl}}/records, Body는 raw JSON으로 설정합니다.
3. 예시 Bearer 값은 {{accessToken}} 변수로만 참조합니다.
4. 응답의 id, score, won을 확인하고 이후 조회용 recordId에 저장합니다.

PowerShell

$body = @{ player_id = 1; game_id = 1; score = 1540; won = $true } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "http://127.0.0.1:8000/records" -ContentType "application/json" -Body $body

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

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

서버는 외래 키와 필드 규칙을 검증한 뒤 새 기록을 저장하고 식별자를 응답합니다. Postman은 응답 JSON을 읽어 다음 요청에서 사용할 컬렉션 변수로 전달할 수 있습니다.

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

!자주 하는 실수

• 실수: 실제 사용자 기록으로 테스트함 해결: 전용 테스트 플레이어와 명확한 닉네임을 사용합니다.
• 실수: 201 대신 본문만 확인함 해결: 상태, 필수 필드, 타입을 함께 검증합니다.
• 실수: 같은 요청을 무제한 재실행함 해결: 고유 테스트 값 또는 정리 DELETE 절차를 둡니다.

✎7. 직접 실습

✎직접 실습

1. 승리 기록과 패배 기록을 하나씩 생성합니다.
2. 없는 player_id로 실패 요청을 저장합니다.
3. 생성 ID를 조회 요청에 넣어 같은 값을 확인합니다.

완료 후 Postman 요청을 저장하고, 실제 API Key·JWT·비밀번호가 이름·본문·스크립트·export 파일에 없는지 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 생성 성공에 201이 적합한 이유는 무엇인가요?
2. 반복 실행 가능한 생성 테스트를 만들려면 무엇이 필요한가요?
3. 외래 키 오류는 어떤 입력에서 발생할 수 있나요?

■9. 핵심 요약

■핵심 요약

POST 생성 테스트는 상태 코드, 응답 스키마, 저장 결과를 모두 확인합니다. 테스트 데이터와 생성 ID를 명시적으로 관리해야 반복 실행이 안전합니다.