3강. Postman 설치와 첫 GET 요청

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

게임 기록·랭킹 API를 테스트하면서 Windows에 Postman을 설치하고 로그인 없이 로컬 GET 요청을 보냅니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

✓2. 학습 목표

✓이 강의를 마치면

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

◇3. 핵심 개념

Postman Desktop 앱은 로그인하지 않아도 경량 API 클라이언트로 요청을 만들고 로컬 기록을 유지할 수 있습니다. 계정과 클라우드 동기화는 협업 선택 사항이지 이 과정의 필수 조건이 아닙니다. 설치 화면과 메뉴 이름은 바뀔 수 있으므로 설치 단계는 Postman 공식 문서의 최신 화면을 우선합니다.

✎4. 단계별 실습

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

1. 공식 설치 문서에서 Windows용 Desktop 앱을 내려받아 설치합니다.
2. 로그인 화면에서는 계정 없이 사용할 수 있는 경량 클라이언트 진입을 선택합니다.
3. 새 HTTP 요청을 열고 메서드 GET, URL {{baseUrl}}/health 대신 우선 실제 주소를 입력해 Send를 누릅니다.
4. Status, Time, Body 패널을 확인합니다.

PowerShell

$baseUrl = "http://127.0.0.1:8000"
Invoke-RestMethod -Method Get -Uri "$baseUrl/health"

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

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

Postman도 PowerShell과 마찬가지로 표준 HTTP 요청을 보냅니다. GUI는 메서드·URL·헤더·본문을 탭으로 나눠 보여 주고, 서버 응답을 상태·시간·크기·본문으로 시각화할 뿐 프로토콜 자체를 바꾸지 않습니다.

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

!자주 하는 실수

• 실수: 계정이 반드시 필요하다고 생각함 해결: 개인 로컬 실습은 로그아웃 상태의 경량 클라이언트로 진행할 수 있습니다.
• 실수: 웹 앱에서 로컬 서버 연결이 안 됨 해결: Desktop 앱 또는 공식 Desktop Agent 요구사항을 확인합니다.
• 실수: Send 전에 서버 주소를 확인하지 않음 해결: PowerShell의 /health 요청부터 성공시킵니다.

✎7. 직접 실습

✎직접 실습

1. 첫 요청 이름을 Health - 성공으로 저장합니다.
2. 응답 JSON을 Pretty와 Raw 보기에서 비교합니다.
3. 서버를 잠깐 멈춰 연결 실패가 어떻게 표시되는지 확인한 뒤 다시 실행합니다.

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

?8. 이해 점검 질문 3개

?이해 점검

1. Postman 계정 없이 가능한 작업은 무엇인가요?
2. Postman과 PowerShell 요청의 공통점은 무엇인가요?
3. 로컬 서버 연결 실패 때 먼저 확인할 두 가지는 무엇인가요?

■9. 핵심 요약

■핵심 요약

Postman은 계정 없이도 로컬 API 테스트에 사용할 수 있습니다. 첫 GET 요청을 저장해 이후 모든 요청의 기준점으로 삼습니다.