8강. Postman 환경 변수와 변수 사용

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

게임 기록·랭킹 API를 테스트하면서 반복되는 주소와 테스트 값을 환경 변수로 분리하고 로컬 값을 안전하게 관리하는 문제를 해결합니다. 수동으로 한 번 성공하는 데서 끝내지 않고 같은 결과를 다시 확인할 수 있는 요청으로 남깁니다.

✓2. 학습 목표

✓이 강의를 마치면

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

◇3. 핵심 개념

환경 변수는 개발·테스트처럼 실행 환경마다 달라지는 값을 요청에서 분리합니다. {{baseUrl}}, {{playerId}}처럼 참조하면 주소를 한 번만 바꿀 수 있습니다. Postman의 로컬 값은 명시적으로 공유하지 않는 한 동기화되지 않지만, 내보낼 파일에는 비밀을 넣지 않는 원칙을 유지합니다.

✎4. 단계별 실습

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

1. game-ranking-local 환경을 만들고 baseUrl=http://127.0.0.1:8000을 설정합니다.
2. playerId=1, accessToken은 빈 값으로 추가합니다.
3. 요청 URL을 {{baseUrl}}/players/{{playerId}}로 바꾸고 활성 환경을 선택합니다.
4. 변수 위에 마우스를 올려 해석된 값을 확인합니다.

PowerShell

$env:GAME_API_BASE_URL = "http://127.0.0.1:8000"
Invoke-RestMethod -Uri "$env:GAME_API_BASE_URL/players/1"

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

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

요청을 보내기 직전에 Postman이 현재 범위에서 변수 값을 찾아 문자열을 치환합니다. 같은 이름이면 더 좁은 범위의 값이 우선하므로 환경 선택과 변수 범위를 함께 확인해야 합니다.

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

!자주 하는 실수

• 실수: 환경을 만들고 선택하지 않음 해결: 오른쪽 위 활성 환경과 변수 미리보기를 확인합니다.
• 실수: 변수 이름 오타를 무시함 해결: 해결되지 않은 {{...}}가 URL에 남았는지 봅니다.
• 실수: 실제 토큰을 공유 값에 저장함 해결: 토큰은 로컬 값 또는 Vault를 사용하고 export 전에 제거합니다.

✎7. 직접 실습

✎직접 실습

1. local과 staging 예시 환경을 만들되 staging 주소는 예시 값만 씁니다.
2. playerId를 바꿔 같은 요청을 재사용합니다.
3. accessToken이 빈 상태인 환경 템플릿을 export해 내용을 검사합니다.

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

?8. 이해 점검 질문 3개

?이해 점검

1. baseUrl을 변수로 분리하면 무엇이 좋아지나요?
2. 변수가 해석되지 않을 때 확인할 두 가지는 무엇인가요?
3. 토큰을 export 파일에 넣지 않아야 하는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

환경 변수는 요청 정의와 환경별 값을 분리합니다. 주소와 테스트 ID는 재사용하되 실제 비밀 값은 로컬에만 두고 공유 파일에서 제거합니다.